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About Backup and Recovery, SC41-5304-06 


This book provides general information about recovery and availability options for 
the IBM iSeries server. It describes the options available on the system, compares 
and contrasts them, and tells where to find more information about them. 


This book release contains minimal information about how to back up your server. 
Look for comprehensive information about backing up your server on the iSeries 
Information Center at the following Web site: 

http:/ /www.ibm.com/eserver /iseries /infocenter. 


This book provides information on the following topics: 


* Procedures on how to save your system with the Save menu options of the GO 
SAVE command. 


* Restoring to different releases of OS/400 

* Selecting the right recovery strategy 

* Procedures for restoring information to your system 
* Device Parity Protection procedures 

* Mirrored protection procedures 

* Uninterruptible power supply 

* Backup and recovery programming techniques 


Who should read this book 


This book is intended for someone who is assigned the responsibilities of backup 
and recovery planning and recovering the system after a failure. You should be 
familiar with the information contained in the Information Center Website before 
using this book. If you know how to operate the system, you should be ready to 
use this book. 


Prerequisite and related information 


Use the iSeries Information Center as your starting point for looking up iSeries 
technical information. 


You can access the Information Center two ways: 
* From the following Web site: 
http://www. ibm.com/eserver/iseries/infocenter 
* From CD-ROMs that ship with your Operating System/400 order: 
iSeries Information Center, SK3T-4091-02. This package also includes the PDF 


versions of iSeries manuals, iSeries Information Center: Supplemental Manuals, 
SK3T-4092-01, which replaces the Softcopy Library CD-ROM. 


The iSeries Information Center contains advisors and important topics such as 
Java, TCP/IP, Web serving, secured networks, logical partitions, clustering, CL 
commands, and system application programming interfaces (APIs). It also includes 
links to related IBM Redbooks and Internet links to other IBM Web sites such as 
the Technical Studio and the IBM home page. 
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With every new hardware order, you receive the iSeries Setup and Operations 
CD-ROM, SK3T-4098-01. This CD-ROM contains IBM @server iSeries Access for 
Windows and the EZ-Setup wizard. iSeries Access offers a powerful set of client 
and server capabilities for connecting PCs to iSeries servers. The EZ-Setup wizard 
automates many of the iSeries setup tasks. 


For other related information, see the|Bibliography” on page 549 


iSeries Navigator 


IBM iSeries Navigator is a powerful graphical interface for managing your iSeries 
servers. iSeries Navigator functionality includes system navigation, configuration, 
planning capabilities, and online help to guide you through your tasks. iSeries 
Navigator makes operation and administration of the server easier and more 
productive and is the only user interface to the new, advanced features of the 
OS/400 operating system. It also includes Management Central for managing 
multiple servers from a central system. 


You can find more information on iSeries Navigator in the iSeries Information 
Center and at the following Web site: 


http://www. ibm.com/eserver/iseries/navigator/ 


How to send your comments 


xvi 


Your feedback is important in helping to provide the most accurate and 
high-quality information. If you have any comments about this book or any other 
iSeries documentation, fill out the readers’ comment form at the back of this book. 


* If you prefer to send comments by mail, use the readers’ comment form with the 
address that is printed on the back. If you are mailing a readers’ comment form 
from a country other than the United States, you can give the form to the local 
IBM branch office or IBM representative for postage-paid mailing. 


* If you prefer to send comments by FAX, use either of the following numbers: 
— United States, Canada, and Puerto Rico: 1-800-937-3430 
— Other countries: 1-507-253-5192 
* If you prefer to send comments electronically, use one of these e-mail addresses: 
— Comments on books: 
RCHCLERK @us.ibm.com 
— Comments on the iSeries Information Center: 
RCHINFOC@us.ibm.com 


Be sure to include the following: 

* The name of the book or iSeries Information Center topic. 

* The publication number of a book. 

* The page number or topic of a book to which your comment applies. 


OS/400 Backup and Recovery V5R2 


Summary of Changes to Backup and Recovery 


New and enhanced functionality that was added to the Operating System/400 
licensed program for Version 5 Release 2 Modification 0. This additional function 
affects backup, recovery, and availability. 


Changes are identified by change bars to the left of the information. 


Changes to this publication include, but are not limited to, support for the 
following: 


* Changes related to the QVFYOBJRST and QFRCCVNRST system values 


* Support for library based objects in independent auxiliary storage pools (ASPs) 
and ASP groups. 


* Support for save and restore of optical volume images to any supported save or 
restore device 


* A step-by-step procedure for recovering your server to another server 


The following topics that existed in previous versions of this book are now located 
in the iSeries Information Center 
(http:/ /www.ibm.com/eserver/iseries/infocenter): 


* Journaling and commitment control 
* Create a logical partition 
* Performance Capabilities Reference, SC41-0607 book 


Moving to online media... 


The iSeries Information Center contains comprehensive information for backing up 
your iSeries or AS/400e server. The hardcopy book contains basic information on 
how to use the Save menu options with the GO SAVE command. This allows you 
to save all or parts of your iSeries or AS/400e system. 


You can download a printable Portable Document Format (PDF) version of each 
topic in this section. 


The iSeries Information Center contains the following topics for backing up your 
system: 


* Planning a backup and recovery strategy 

* Setting up disk protection for your data 

* Controlling system shutdown using a power-handling program. 
* Getting your media ready to save your system 

* Before you save anything... 


* Saving your system with the GO SAVE command (also in|’Save your server] 
with the GO SAVE command” on page 15). 


* Manually saving parts of your system 

* Saving your system while it is active 

* Saving to multiple devices to reduce your save window 
* Restoring a Windows server 

* Journal management 
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* Commitment control 
Note: 


Access the iSeries Information Center at the following Web site: 
http://www. ibm.com/eserver/iseries/infocenter 
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Chapter 1. Options for Backup, Recovery, and 
Availability—Overview 


Today, computer systems and the applications and information that they provide 
are at the heart of most businesses. Without the critical functions they 
support-customer service, sales, order processing, distribution, 
manufacturing—business quickly comes to a halt. You need to plan backup, 
recovery, and system availability to protect your ability to maintain crucial 
business functions no matter what happens. Planning can mean the difference 
between business success and business failure. 


IBM iSeries and AS/400e servers offer a wide range of recovery and availability 
options. Your hardware or software includes some of the options. Others are 
ordered separately. They are intended to help you do the following: 


* Make your save operations faster and more efficient. 
* Keep your system available for your users. 
* Plan and manage your backup and recovery. 


This chapter provides an overview of the options. The iSeries Information Center 
provides comparisons of the options. Use this information to decide what other 
options beyond the basics might be useful, affordable, and practical for your 
situation. The overview of each option tells you where you can find more 
information if that option appeals to you. 


The remaining parts of this book include the following topics: 
* Recovering your system. 
* Configuring disks and disk protection. 


Save and Restore Operations—Overview 


Your Operating System /400 (OS/400) licensed program includes menus and 
commands for save and restore. You can use the save operations and restore 
operations on the system to do the following: 


* Recover from a program or system failure. 
* Exchange information between servers. 


* Store infrequently used objects offline. 


You can use commands and menu options to save individual objects and groups of 
objects. You can use some save and restore operations while your system is active. 

Other save and restore operations require that no other activity is occurring on the 
system. 


You can save and restore objects by using diskette, magnetic tape, optical media, or 
a save file. You can also use communications capabilities or an optical connection 
to save and restore objects with another system. 


If your system is busy most of the time, you can use the save-while-active function 


to reduce the time period that the system is unavailable while you are performing 
save operations. 


© Copyright IBM Corp. 1997, 2002 3 


Comprehensive information about save procedures and the save-while-active 
functions are in the Information Center. You can read more about restore 


procedures in|Chapter 3, “Restore Procedures—General Information” on page 41 


Tape Units—Overview 


The iSeries and AS/400e servers offer many different types of tape units to meet a 
variety of requirements for performance, capacity, and cost. In many cases, you can 
attach enough tape drives with sufficient media capacity to save your entire system 
without operator intervention. This allows a complete unattended save operation. 


For more information about the tape units that are available to attach to your 
system, call 1-800-IBM-CALL (1-800-426-2255). You can read about tape 
performance in the Performance Capabilities Reference, ZC41—-0607. 


Automated Tape Library Systems—Overview 


Automated tape library systems are a combination of hardware and software that 
store, catalog, and load large numbers of tapes without operator intervention. On 
iSeries and AS/400e servers, Backup Recovery and Media Services (BRMS/400) 
software supports the use of an automated tape library system. 


You can read more about using automated tape library systems with the iSeries 
and AS/400e servers in the Manage Tape Libraries topic in the iSeries Information 
Center (http://www.ibm.com/eserver /iseries /infocenter) 


Alternate Installation Device-Overview 


Alternate Installation Device support allows you to perform installation and 
recovery procedures using a combination of devices. Previously, these types of 
activities could only be performed using devices attached to the first system bus. 
Now, you can use a combination of devices that are attached on the first system 
bus and on additional buses. 


If you use this function, the system uses existing support (a device on the first 
system bus) to install or recover enough of the Licensed Internal Code required to 
perform an IPL with IPL-type D. Then, using the new alternate installation device 
support, the system continues the operation using media in the alternate 
installation device. This new function supports installation and recovery from tape 
media, such as SAVSYS tapes or distribution tapes which you created, that contains 
Licensed Internal Code and may contain the operating system, licensed programs, 
and data. 


Some models, typically with high speed tape devices attached, may see a 
performance improvement when using an alternate installation device for save 
operations. 


Optical Media Support—Overview 


You can save your entire system, all of your system data, or all of your user data, 
to optical media. The OS/400® save and restore commands support 
directly-attached optical library devices, CD-ROM standalone devices, and 
DVD-RAM standalone devices. LAN-attached optical library devices are not 
supported. Optical media is an economical alternative to tape for save/restore 
operations on entry level systems. 
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At V5R2 you can use the SAV command to back up data from optical volumes to 
any supported save/restore device, such as tape, diskette, optical, or save file, by 
way of an optical volume image. The Optical Support, (SC41-5310), book provides 
more information about using optical media. 


Journal Management—Overview 


You can use journal management to recover the changes to various objects that 
have occurred since your last complete save. 


You use a journal to define what objects you want to protect with journal 
management. This is often referred to as journaling an object. A journal receiver 
contains the entries (called journal entries) that the system adds when events 
occur that are journaled, such as changes to database files, changes to other 
journaled objects, or security-relevant events. See the Journal Management topic in 
the iSeries Information Center (http://www.ibm.com/eserver /iseries /infocenter) 
for a list of object types that can be journaled. 


You can use the remote journal function to set up journals and journal receivers on 
a remote iSeries or AS/400eserver. These journals and journal receivers are 
associated with journals and journal receivers on the source system. The remote 
journal function allows you to replicate journal entries from the source system to 
the remote system. 


The main purpose of journal management is to assist in recovery. You can also use 
the information that is stored in journal receivers for other purposes, such as: 
* An audit trail of activity that occurs for various objects on the system. 


* Assistance in testing application programs. You can use journal entries to see the 
changes made by a particular program. 


You can read more about planning and setting up journal management in the 
Journal Management topic in the iSeries Information Center at 
http:/ /www.ibm.com/eserver /iseries /infocenter. 


Access-Path Protection—Overview 


An access path describes the order in which records in a database file are 
processed. A file can have multiple access paths, if different programs need to see 
the records in different sequences. If your system ends abnormally when access 
paths are in use, the system may have to rebuild the access paths before you can 
use the files again. This is a time-consuming process. To perform an IPL on a large, 
busy iSeries or AS/400e server that has ended abnormally can take many hours. 


You can use journal management to keep a record of changes to access paths. This 
greatly reduces the amount of time it takes the system to perform an IPL after it 
ends abnormally. 


Two methods of access-path protection are available: 
* System-managed access-path protection 
* Explicit journaling of access paths 


System-Managed Access-Path Protection 


You can allow the system to determine which access paths to protect. You specify 
target recovery times for access paths for the entire system or for auxiliary storage 
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pools (ASPs). Your system has a default recovery time for access paths for the 
entire system of 70 minutes when it is shipped. You can use the Edit Recovery for 
Access Paths (EDTRCYAP) command to see and change the target recovery times 
for access paths and to see how much space the system is using for 
system-managed access-path protection (SMAPP). 


SMAPP provides a simple method to reduce your recovery time after an abnormal 
system end. SMAPP manages the required environment for you. You do not need 
to use any type of journal management to use SMAPP. 


When you use SMAPP, the system decides which access paths to protect, based on 
overall target recovery times for access paths. You may want to make sure that 
certain access paths are protected because they are critical to your business. You 
can use journal management to explicitly protect access paths on your system. 


You can use a combination of SMAPP and explicit journaling of access paths. The 
system evaluates the protected and unprotected access paths to develop its strategy 
for meeting your recovery targets for access paths. 


You can read more about SMAPP in the Journal Management topic in the iSeries 
Information Center (http://www.ibm.com/eserver /iseries /infocenter). 


Commitment Control—Overview 


Commitment control is an extension of journal management that assists you in 
keeping your database files synchronized. A single transaction on your system may 
update more than one database file. If your system is in a network, a single 
transaction may update files on more than one system. 


Commitment control helps ensure that: 
* All changes within a transaction are completed for all files that are affected. 


* If processing is interrupted before the transaction is completed, all changes 
within a transaction are removed. 


* Changes that are made during a transaction can be removed when the user 
program determines that it is necessary to do so. This is called a rollback 
operation. 


Without commitment control, recovering data for a complicated program requires 
detailed application and program knowledge. Programs that are interrupted cannot 
easily be started again. To restore the data to the last completed transaction, you 
may need to write a user program or use data file utility (DFU) to reverse the 
database updates that are not complete. 


The commit (COMMIT) and rollback (ROLLBACK) operations are available in 
several iSeries or AS/400e server programming languages including ILE RPG*, ILE 
COBOL*, ILE C*, control language (CL), and Structured Query Language (SQL). 


You can read more about commitment control in the Database topic of the iSeries 
Information Center (http://www.ibm.com/eserver /iseries /infocenter). 
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Auxiliary Storage Pools—Overview 


Your system may have many disk units attached to it for auxiliary storage of your 
data. To your system, they look like a single unit of storage. The system spreads 
data across all disk units. You can use auxiliary storage pools to separate your disk 
units into logical subsets. 


An auxiliary storage pool (ASP) is a group of units that are defined from all the 
disk units that make up auxiliary storage. It is a software definition of how the 
disk units are arranged. An ASP does not necessarily correspond to the physical 
arrangement of disks. 


ASPs allow you to isolate objects on one or more specific disk units. This may 
reduce the loss of data due to a disk media failure. In most cases, only data that is 
stored on disk units in the affected ASP is lost. However, when a disk unit fails, 
the entire system is unusable until the disk unit is repaired, unless the failed unit 
is protected by device parity protection or mirrored protection. 


ASPs are used to manage system performance and backup requirements: 


* You can create an ASP to provide dedicated resources for frequently used 
objects, such as journal receivers. 


* You can create an ASP to hold save files. Objects can be backed up to save files 
in a different ASP. It is unlikely that both the ASP that contains the object and 
the ASP that contains the save file will be lost. 


* You can create different ASPs for objects with different recovery and availability 
requirements. For example, you can put critical database files or documents in 
an ASP that has mirrored protection or device parity protection. 


* You can create an ASP to place infrequently used objects, such as large history 
files, on disk units with slower performance. 


* You can use ASPs to manage recovery times for access paths for critical and 
noncritical database files using system-managed access-path protection. 


Several types of ASPs are available on the system: 


* The system creates the system ASP (ASP 1) and is always configured. It contains 
the Licensed Internal Code, licensed programs, system libraries, and temporary 
system work space. The system ASP also contains all other configured disk units 
that are not assigned to a user ASP. 


* Grouping together a physical set of disk units and assigning them a number (2 
through 32) creates a basic user ASP. ASP 1 is always reserved as the system 
ASP. 


* ASPs 33 through 255 are independent user ASPs, also known as independent 
disk pools in iSeries’ Navigator. You can use clustering software to make them 
switchable ASPs. When you make an independent ASP switchable, you can 
switch it among iSeries 400® servers or logical partitions. If you choose to switch 
these ASPs among iSeries 400 servers, the ASPs must consist of external disk 
units. If you choose to switch these ASPs among logical partitions, the ASPs can 
consist of internal disk units. Three types of independent disk pools exist: 
primary, secondary, and UDFS. Primary and secondary disk pools can store 
directories and libraries; they can function together in a disk pool group. UDFS 
disk pools can only store user-defined file systems; they cannot be part of a disk 
pool group. To configure independent ASPs, you must use iSeries Navigator. 
You can find more information about independent ASPs in the Information 
Center web site at this URL: 


http://www. ibm.com/eserver/iseries/infocenter/ 
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You_can read more about ASPs in |Chapter 20, “Working with Auxiliary Storage 
Pools” on page 403 


Mirrored Protection—Overview 


If a disk failure occurs, mirrored protection is intended to prevent data from being 
lost. Mirrored protection is a software function that uses duplicates of disk-related 
hardware components to keep your system available if one of the components 
fails. It can be used on any model of the iSeries or AS/400e server and is a part of 
the Licensed Internal Code. 


Different levels of mirrored protection are possible, depending on what hardware 
is duplicated. You can duplicate: 


¢ Disk units 

* Disk controllers 

* Disk I/O processors 

* Rings or high-speed links (HSL) 
¢ Towers 

* Buses 

* Remote buses 


The system remains available during the failure if a failing component and the 
hardware components that are attached to it are duplicated. 


You can read more about mirrored protection in |Chapter 22, “Working with 
irrored Protection” on page 443 


Device Parity Protection—Overview 


Device parity protection is intended to prevent data from being lost if a disk 
failure occurs. In many cases, device parity protection can also prevent your 
system from stopping when a disk unit fails. Device parity protection provides the 
following: 


* Technology similar to the RAID-5 (redundant array of independent disks) 
technique 


* Redundant power 
* Concurrent maintenance for single disk failures 


Device parity protection is a hardware function that is available for input/output 
adapter features. Device parity protection uses a data redundancy technique to 
protect the data. To improve performance the parity information in the disk unit 
subsystems with device parity protection is spread across multiple units. 


When a failure occurs on a disk unit subsystem that has device parity protection, 
the data is reconstructed. The disk subsystem controller automatically reconstructs 
the data from the active units in the disk unit subsystem. The system continues to 
run while the data is being reconstructed. 


When a failure occurs on a disk unit subsystem that does not have device parity 


protection or mirrored protection, you cannot use the system until the disk unit is 
repaired or replaced. 
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If possible, you should protect all the disk units on your system with either device 
parity protection or mirrored protection. This prevents the loss of information 
when a disk failure occurs. In many cases, you can also keep your system running 
while a disk unit is being repaired or replaced. 


You can read more about device parity protection in |Chapter 21, “Working with 
Device Parity Protection” on page 427) 


Comparison of Disk Protection Options 
compares the disk protection options: 


Table 1. Comparison of Disk Protection Options. Yes indicates the component is protected. The system does not stop 
when that component fails. 


Disk Component Device Parity Protection Mirrored Protection 
Bus No Yes” 

IOP No Yes” 
Controller No Yes” 

Power supply Yes" Yes? 

Disk drive Yes Yes 

” Only on the 9337 Disk Array Subsystem. 


4 Mirrored protection protects this component if your system has sufficient redundant hardware. 


Uninterruptible Power Supply—Overview 


An uninterruptible power supply providesauxiliary power to the processing unit, 
disk units, system console, and other devices that you choose to protect. When you 
use an uninterruptible power supply with the iSeries or AS/400e server, you can: 


* Continue operations during brief power interruptions. 

* Provide normal ending of operations to reduce the recovery time when the 
system is restarted. If the system ends abnormally before completing a normal 
ending of operations, the recovery time can be significant. 


* Protect the system from voltage peaks. 


Normally, an uninterruptible power supply does not provide power to all work 
stations. You should design your interactive applications to handle the loss of 
communications with a workstation. Otherwise, system resources are used to 
attempt to do error recovery for workstations that have lost power. 


The programming language reference manuals provide examples of how to use the 
error feedback areas to handle workstations that are no longer communicating with 
the application. The Information Center describes how to develop programs to 
handle an orderly shutdown of the system when the uninterruptible power supply 
unit takes over. 


Look for this information in the Backup, Recovery, and Availability topics at the 
following Web site: http://www.ibm.com/eserver /iseries /infocenter. 
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Dual Systems—Overview 


Installations with very high availability requirements use a dual-systems approach. 
Some or all data is maintained on two systems. The secondary system can take 
over critical application programs if the primary system fails. 


The most common method for maintaining data on the secondary system is 
through the use of journaling. Journal entries from the primary system are 
transmitted to the secondary system. A user-written program on the secondary 
system receives the journal entries and uses them to update journaled objects. 


In this method, the journal entries are transmitted at the application layer by using 
the Receive Journal Entry (RCVJRNE) commmand or the Retrieve Journal Entries 
(QjoRetrieveJournalEntries) API. Using the Remote Journal function improves this 
method. This function allows the primary system to transmit the journal entries to 
a duplicate journal receiver on the secondary system at the microcode layer. For 
more information on the Remote Journal function, refer to the Journal Management 
topic in the iSeries Information Center 
(http://www.ibm.com/eserver/iseries/infocenter). 


A third method is to copy journal receivers to tape regularly. The journal receivers 
are then restored to the secondary system. A user-written program uses the journal 
entries to update the objects on the secondary system. 


Several software packages are available from independent software vendors to 
support dual systems on the iSeries or AS/400e server. 


ObjectConnect—Overview 


The ObjectConnect function provides the ability to move entire objects between 
systems using an optical connection, a communications line, or a local area 
network (LAN). The ObjectConnect function provides a set of save and restore 
(SAVRSTxxx) commands. For example, you can use the SAVRSTLIB command to 
save one or more libraries, send the libraries over an optical connection to a 
specified system, and restore the libraries. 


The ObjectConnect support is provided at a low level in the operating system. It 
provides better performance than other methods of transferring objects, such as 
using save files. You can read more about ObjectConnect in the Connecting to 
iSeries topic in the iSeries Information Center 

(http:/ /www.ibm.com/eserver/iseries/infocenter). 


OptiConnect for OS/400—Overview 


OptiConnect for OS/400 support provides the capability of linking iSeries or 
AS/400e servers with a fiber-optic bus. You can use OptiConnect for OS/400 with 
dual system products and with ObjectConnect to move objects between systems 
quickly and efficiently. You can read more about OptiConnect for OS/400 in 
OptiConnect for OS/400, SC41-5414-03. 
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Backup Recovery and Media Services for iSeries—Overview 


The Backup Recovery and Media Services for iSeries (BRMS/400) licensed program 
offers a set of functions for defining and performing these tasks: 


* Backup 

* Recovery 
* Archiving 
° Retrieval 


* Media management 


Starting with V5R1, Backup Recovery and Media Services provides a graphical 
user interface for backup and recovery that is integrated into iSeries Navigator. You 
can use Backup Recovery and Media Services to simplify and automate your 
backups and to manage your media. 


Backup Recovery and Media Services keeps track of what you have saved, when 
you saved it, and where it is saved. When you need to do a recovery, Backup 
Recovery and Media Services helps ensure that the correct information is restored 
from the correct tapes in the correct sequence. 


You can read more about Backup Recovery and Media Services in the Backup 
Recovery and Media Services for iSeries, SC41-5345-03 book, the iSeries Information 
Center at http://www. ibm.com/eserver/iseries/infocenter, or the Backup 
Recovery and Media Services website, 

http://www. ibm.com/eserver/iseries/service/brms.htm.. 


Tivoli Storage Manager—Overview 


You can use Tivoli Storage Manager to protect data on your workstations and LAN 
file servers. The Tivoli Storage Manager can automatically back up critical LAN 
and workstation data and archive files that are used infrequently. It provides a 
disaster recovery solution for LANs and workstations. 


Administer the Tivoli Storage Manager from a client workstation that is attached to 
an iSeries server. It can back up data from a variety of workstation platforms. You 
can use the Backup Recovery and Media Services (BRMS/400) program to back up 
user data to any Tivoli Storage Manager when the server in a client/server 
environment. You can use Backup Recovery and Media Services for iSeries to 
manage the data that you save on the Tivoli Storage Manager and to manage the 
backup of the system data to local media. 


You can read more about the Tivoli Storage Manager at the following Web site: 
http://www.tivoli.com/support/storage_megr/ad4serv.htm. 


Content Manager OnDemand for iSeries Server—Overview 


You can buy the Content Manager OnDemand for iSeries product. You can use 
Content Manager OnDemand for iSeries to create search criteria and a search index 
for large volumes of data, such as history reports or files, that you want to archive. 
You can archive the data either to a folder or to optical media. You can retrieve 
specific archived data that meets your search criteria. 


Chapter 1. Options for Backup, Recovery, and Availability-Overview 11 


Business Continuity and Recovery Services—Overview 


IBM Business Continuity and Recovery Services (BCRS) offers an extensive 
portfolio of services to help you design, set up, and manage a comprehensive, 
enterprise-wide iSeries 400 or AS/400e business continuity and recovery strategy. 
BCRS can help you minimize the effects of network and system outages and plan 
for their efficient recovery. BCRS consultants can help you do the following: 


* Evaluate critical business functions and applications. 
* Assess your system environment. 


* Design a recovery plan to keep your business running in the event of an 
extended outage. 


BCRS recovery centers are equipped with the latest iSeries and AS/400e server 
technologies. They are staffed with technical experts to assist you in testing your 
recovery plan and performing a recovery in the event of a disaster. 


For more information about Business Continuity and Recovery Services, please call 
1-800-599-9950. 


Data Migration Service Offerings—Overview 


The AS/400® DASD Migration Service Offering (GIGMIG) is a service offering to 
migrate the disk (DASD) on your iSeries server to different disk technology 
without reloading your entire system. GIGMIG offerings include the following: 


* Replacing all disks on the system. 
* Adding new disks and removing some existing disks. 
* Moving disks between ASPs. 


SYSMIG is a service offering to migrate your data from one iSeries server to 
another iSeries server. 


For more information about GIGMIG and SYSMIG, please call 1-800-IBM-4YOU 
(1-800-426-4968). 
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Part 2. Saving Information on Your System 
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Chapter 2. Saving your Server 


Look for comprehensive information about how to backup your iSeries server on 
the iSeries Information Center on the Internet. See |Prerequisite and related 


information” on page xv|for information on how to access the Information Center. 


If this is your first experience with your iSeries server, use the following 
instructions to save all of the information on your iSeries server. Do this with the 
GO SAVE menu options. The instructions in the book are the same as the 
instructions in the Information Center. 


You can browse the Information Center, or print out a copy of the information on 
how to backup your entire iSeries server. 


Note: To avoid data loss, if you have either of these products installed on your 
system, please read this notice before upgrading to OS/400 Version 4, 
Release 5 or later releases: 


* 5769SA3 - OS/400 Integration for Novell NetWare 
* 5769XZ1 - OS/2® Warpserver for AS/400 


Once you install OS/400 Version 4, Release 5 or later releases, these 

products will no longer work. You cannot use Restore License Programs to 

load a previous release of these products onto a server with V4R5 or later 

version of the operating system. To avoid losing data that depends on these 

products, migrate that data from your server to an accessible location before 

upgrading to Version 4, Release 5. 

* For assistance in migrating your data to AS/400 Netserver, see the 
redbook Advantage AS/400 NetServer, SG24-5196. 

* For additional information, read the redpiece: Migration Options for: 
OS/2 Warp Server for AS/400 and OS/400 Integration for Novell 
NetWare. 


* For alternative ideas to help migrate your data, see information APAR 
1111689. 


Save your server with the GO SAVE command 


Using the GO SAVE command is a simple way to make sure that you have a good 
backup of your entire server. The GO SAVE command presents you with Save 
menus that make it easy to back up your server, no matter what backup strategy 
you decide to use. It is a good idea to use menu option 21 of the GO SAVE 
command right after you install your server. 


Menu option 21 of the GO SAVE command is the basis for all save strategies. This 
option allows you to perform a complete save of all the data on your server. Once 
you have used menu option 21, you can use other menu options to save parts of 
the server, or to use a manual save process. 


Another save method uses Backup Recovery and Media Services (BRMS/400), 
which automates your save processes. BRMS provides a comprehensive and easy 
solution for your backup and recovery needs. You can read more about BRMS in 
the iSeries Information Center 


http://www. ibm.com/eserver/iseries/infocenter 
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The following figure illustrates the commands and menu options you can use to 
save the parts of the server and the entire server. 


Options from 
Save menu 


j 
| Licensed Internal Code me _ 
22 OS/400 Objects in QSYS 


| User Profiles SAVSECDTA 
23 Private Authorities | 


| -_—— 
Configuration Objects SAVCFG 
+! 
IBM-supplied Directories 


OS/400 Optional Libraries 
*QHLPSYS 
* QUSRTOOL 


Licensed Program Libraries 
* QRPG 

* QCBL 

* OXxxxx 


Commands 


IBM Libraries with User Data 
* QGPL 

-QUSRSYS 

* QS36F 

-# LIBRARY 


User Libraries 
* LIBA 
-LIBB 
= « LIBC 
* LIBxxx 


Documents and Folders | 

Distribution Objects | 
= 

User Objects in Directories SAV 
nl 


Figure 1. Save commands and menu options 


The following information provides an overview and procedures on how to use 
menu options of the GO SAVE command: 


e |4 


‘Overview of the GO SAVE command menu options” on page 17} explains how 
to start the GO SAVE command. 
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* |“Change Save menu defaults with GO SAVE: Option 20” on page 18)explains 


how to customize the default GO SAVE command menu options. 


* |“Save your whole server with GO SAVE: Option 21” on page 19/explains how to 


use menu option 21 when performing a full save of the server. 


* |“Save system data with GO SAVE: Option 22” on page 19}explains how to save 


your data only after you perform a full save. 


* |“Save user data with GO SAVE: Option 23” on page 20] explains how to save 


your user data only after you perform a full save. 


“Save parts of your server with other GO SAVE command menu options” on 


page 21}explains other GO SAVE command menu options. 


step-by-step instructions on how to use the GO SAVE command menu options. 


Overview of the GO SAVE command menu options 


Access the GO SAVE command menu by typing GO SAVE from any command 
line. From the Save menu, you see option 21, option 22, and option 23 along with 
many more save options. A single plus sign (+) indicates that the option places 
your server into a restricted state, which means that nothing else can be running 
on your system when the menu option is selected. A double plus sign (++) 
indicates that your server must be in a restricted state before you can run this 
option. 


(Save Save 2 


Select one of the following: 


Data 

Files 

Libraries 

Documents and folders 
Programs 

Other objects 

Changed objects only 
Licensed programs 
Security data 

Storage 

Configuration 

Objects in directories 


n 
m@ 
< 
Oo 


+ 
+ 


FPOWOON A TOF WNE 


ji 
\ 


Figure 2. Save Menu-—First Display 


Page down on the Save menu to see additional options: 


Save System and User Data 
20 Define save system and user data defaults 
++ 21 Entire system 
++ 22 System data only 
+ 23 All user data 
Save Document Library Objects 
30 All documents, folders, and mail 
ol New and changed documents, new folders, all mail 
32 Documents and folders 
33 Mail only 
34 Calendars 
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Save Libraries 
++ 40 All libraries other than the system library 
41 All IBM libraries other than the system library 
42 All user libraries 
43 All changed objects in user libraries 
Save for Different Systems 
50 Save in System/36 format 


The following topics describe how to use the menu options of the GO SAVE 
command: 


* |“Change Save menu defaults with GO SAVE: Option 20”)explains how to 


customize the default GO SAVE command menu options. 


* |“Save your whole server with GO SAVE: Option 21” on page 19/explains how to 


use menu option 21 when performing a full system save. 


* |“Save system data with GO SAVE: Option 22” on page 19}explains how to save 


your system data only after you perform a full save. 


* |“Save user data with GO SAVE: Option 23” on page 20)explains how to save 


your user data only after you perform a full save. 


¢ |“Save parts of your server with other GO SAVE command menu options” on 


explains other automated GO SAVE command menu options. 


* |“Use GO SAVE: Options 21, 22, and 23” on page 21|provides you with 


step-by-step instructions on how to use the GO SAVE command menu options. 


Change Save menu defaults with GO SAVE: Option 20 


You can use save menu option 20 to change the default values for the GO SAVE 
command, menu options 21, 22, and 23. This option simplifies the task of setting 
your save parameters and helps to ensure that operators use the options that are 
best for your system. 


In order to change the defaults, you must have *CHANGE authority for both the 
QUSRSYS library and the QSRDFLTS data area in the QUSRSYS library. 


When you enter the GO SAVE command, then select menu option 20, the server 
displays the default parameter values for menu options 21, 22, and 23. If this is the 
first time you have used option 20 from the Save menu, the server displays the 
IBM-supplied default parameter values. You can change any or all of the parameter 
values to suit your needs. For example, you can specify additional tape devices or 
change the message queue delivery default. The server saves the new default 
values in data area QSRDFLTS in library QUSRSYS. The server creates the 
QSRDFLTS data area only after you change the IBM-supplied default values. 


Once you define new values, you no longer need to worry about which, if any, 
options to change on subsequent save operations. You can simply review your new 
default options and then press Enter to start the save with the new default 
parameters. 


If you have multiple, distributed servers with the same save parameters on each 
server, this option provides an additional benefit. You can simply define the 
parameters from the Save menu, using option 20 on one server. Then, save the 
OSRDFLTS data area, distribute the saved data area to the other servers, and 
restore it. 
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Save your whole server with GO SAVE: Option 21 


Option 21 saves everything on your server and allows you to perform the save 
while you are not there. Option 21 does not|save spooled files 

Option 21 saves all of your data for additional licensed programs, such as Domino 
or Integration for Windows Server when you select to vary off your network 


servers. Also, if you have Linux installed on a secondary logical partition, you can 
back up that partition when you select to vary off your network servers. 


Option 21 puts your server into a restricted state. This means that when the save 
begins, no users can access your server and the backup is the only thing that is 
running on your server. It is best to run this option overnight for a small server or 
during the weekend for larger servers. If you schedule an unattended save, make 
sure your server is in a secure location; after you schedule the save, you will not 
be able to use the workstation where the backup is initiated until the save is 
complete. 


Note: If you are saving information on independent ASPs (also called independent 
disk pools in iSeries Navigator), make sure that you have varied on the 
independent ASPs that you want to save before using Option 21. For more 
information about independent ASPs , see the iSeries Information Center at 
http://www. ibm.com/eserver/iseries/infocenter. 


Option _ Description Commands 
Number 
21 Entire server ENDSBS SBS(*ALL) OPTION (*IMMED) 
(QMNSAVE) CHGMSGQ MSGQ(QSYSOPR) DLVRY(*BREAK or *NOTIFY) 
SAVSYS 


SAVLIB LIB(*NONSYS) ACCPTH(#*YES) 
SAVDLO DLO(*ALL) FLR(*ANY) 
SAV DEV('/QSYS.LIB/media-device-name.DEVD') + 
OBJ(('/*') ('/QSYS.LIB' *OMIT) + 
(‘/QDLS' *OMIT))* UPDHST(*YES) 
STRSBS SBSD(controlling-subsystem) 
1The command omits QSYS.LIB file system because the SAVSYS command and the SAVLIB 
LIB(*NONSYS) command both save it. The command omits the QDLS file system because 
the SAVDLO command saves it. 


“Use GO SAVE: Options 21, 22, and 23” on page 21|}provides you with step-by-step 


instructions on how to save your entire server with menu option 21 of the GO 
SAVE command. 


Save system data with GO SAVE: Option 22 


Option 22 saves only your system data. It does not save any user data. Option 22 
puts your server into a restricted state. This means that no users can access your 
server, and the backup is the only thing that is running on your server. 
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Option _ Description Commands 


Number 
22 System data only ENDSBS SBS(*ALL) OPTION(*IMMED) 
(QSRSAVI) CHGMSGQ MSGQ(QSYSOPR) DLVRY(*BREAK or *NOTIFY) 
SAVSYS 


SAVLIB LIB(*IBM) ACCPTH(#YES) 
SAV DEV('/QSYS.LIB/media-device-name.DEVD') + 
OBJ(('/QIBM/ProdData') + 
('/QOpenSys/QIBM/ProdData')) + 
UPDHST (*YES) 
STRSBS SBSD(controlling-subsystem) 


“Use GO SAVE: Options 21, 22, and 23” on page 21|provides you with step-by-step 


instructions on how to save your system data with menu option 22 of the GO 
SAVE command. 


Save user data with GO SAVE: Option 23 


Option 23 saves all user data. This information includes files, records, and other 
data that your users supply into your server. Option 23 puts your server into a 
restricted state. This means that no users can access your server, and the backup is 
the only thing that is running on your server. 


Note: If you are saving information on independent ASPs (also called independent 
disk pools in iSeries Navigator), make sure that you have varied on the 
independent ASPs that you want to save before using Option 23. For more 
information about independent ASPs , see the iSeries Information Center at 
http://www. ibm.com/eserver/iseries/infocenter. 


Option _ Description Commands 
Number 
23 All user data ENDSBS SBS(*ALL) OPTION (*IMMED) 
(QSRSAVU) CHGMSGQ MSGQ(QSYSOPR) DLVRY(*BREAK or *NOTIFY) 
SAVSECDTA 
SAVCFG 


SAVLIB LIB(*ALLUSR) ACCPTH(*YES) 
SAVDLO DLO(*ALL) FLR(*ANY) 
SAV DEV('/QSYS.LIB/media-device-name.DEVD') + 
OBJ(('/*') ('/QSYS.LIB' *OMIT) + 
(‘/QDLS' *OMIT) + 
(‘/QIBM/ProdData' *OMIT) + 
('/QOpenSys/QIBM/ProdData' *OMIT))* + 
UPDHST(*YES) 
STRSBS SBSD(controlling-subsystem) 
Menu option 23 omits the QSYS.LIB file system because the SAVSYS command, the 
SAVSECDTA command, the SAVCFG command, and the SAVLIB LIB(*ALLUSR) command 
save it. The command omits the QDLS file system because the SAVDLO command saves it. 
Menu option 23 also omits the /QIBM and /QOpenSys/QIBM directories because these 
directories contain IBM supplied objects. 


“Use GO SAVE: Options 21, 22, and 23” on page 21|provides you with step-by-step 


instructions on how to save your user data with menu option 23 of the GO SAVE 
command. 
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Save parts of your server with other GO SAVE command 
menu options 
You may perform the following GO SAVE command menu options. 


Option Description Commands 

Number 

40 All libraries other ENDSBS SBS(*ALL) OPTION(*IMMED) 
than the system CHGMSGQ MSGQ(QSYSOPR) DLVRY(*BREAK) 


library (QMNSAVN) — SAVLIB LIB(*NONSYS) ACCPTH(*YES) 
STRSBS SBSD(controlling-subsystem) 


other than the system 
library 
42 All user libraries SAVLIB LIB(*ALLUSR) 
43 All changed objects saycHGOBJ LIB(*ALLUSR) 


in user libraries 


Use GO SAVE: Options 21, 22, and 23 
Use the following checklist for menu options 21, 22, and 23 of the GO SAVE 
command. When appropriate, select the option that you require. If you choose to, 
ou_can print system information during the procedure. Otherwise, [“Printing] 
E stem in formation” on pene Svicontins detailed inctucionc or haw Opal 
system information if you do not want the Save menu option command to print 
your system information automatically. 


Some of the steps in this checklist may not apply to your system configuration. If 
you are not sure how your system is configured, contact your system 
administrator. 


1. Sign on with a user profile that has *SAVSYS and *JOBCTL special authorities, 
and also has sufficient authority to list different types of server resources. (The 
QSECOFR user profile contains all of these authorities.) This ensures that you 
have the authority that you need to place the server in the necessary state and 
to save everything. 


2. If you have independent ASPs, make them available before ending iSeries 
Navigator if you want them to be included in an Option 21 or 23 save. 


For more information see the Systems management —> Disk Management 
—> Independent disk pools in the iSeries Information Center at 
http: //www.ibm.com /eserver/iseries /infocenter. 


3. If you are operating in a clustered environment and want to save independent 
ASPs without causing a failover, or you want to save the cluster environment 
for a node, you must end the device cluster resource group and end clustering 
before you end subsystems. 


For more information, refer to the online help in the Simple Cluster 
Management utility or see the Clusters topic in the iSeries Information Center 
at http: //www.ibm.com /eserver /iseries /infocenter. 


4. If you have OptiConnect controllers, vary them off prior to the save operation. 
You must vary off OptiConnect controllers before ending subsystems and 
performing a save of the entire server, or before any save that ends the QSOC 
subsystem. If you do not vary off OptiConnect controllers before ending 
subsystems, they go into a failed status, the server marks them as damaged, 
and the server does not save them. For more information, see OptiConnect for 
OS/400, SC41-5414-03. 
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5. Make sure that iSeries Access is not active at your workstation. To deactivate 
iSeries Access: 


a. From the PC workstation, double-click the iSeries Workstation icon. 


Ss 


Double-click the Connections icon. 
Click Disconnect. 


If you have MQGeries (5733-A38), you need to quiesce MQSeries before 
you save the server. The MQSeries for OS/400 Administration, GC33-1356 
book has instructions for quiescing MQSeries. 


a9 


6. If you plan to run the save procedure immediately, make sure that no jobs are 
running on the server: type WRKACTJOB. 


If you plan to schedule the save procedure to run later, send a message to all 
users informing them when the server will be unavailable. 

7. Type GO SAVE at a command prompt to display the Save menu. 

8. To perform an attended save of your server, go to step 

9. To perform an unattended save operation, continue with the following steps. 


An unattended save operation prevents your save operation from stopping 
because of unanswered messages: 


a. Display the reply list sequence numbers to find what numbers are 
available for use: 
WRKRPYLE 

b. If MSGID(CPA3708) is not already in your reply list, add it. For xxxx, 
substitute an unused sequence number from 1 through 9999: 


ADDRPYLE SEQNBR(xxxx) + 
MSGID(CPA3708) + 
RPY('G') 
c. Change your job to use the reply list and to notify you of any break 
messages that are sent: 


CHGJOB INQMSGRPY(*SYSRPYL) BRKMSG(*NOTIFY) 


Note: You can also set up a default so that whenever you select menu options 
21, 22, or 23, the server will always use the reply list. To set up the 


default, select from the Save menu. Specify Yes on the 


Use system reply list option. 
10. Select the option (21, 22, or 23) from the Save menu and press the Enter key. 
A prompt display describes the function of the menu option that you selected. 


11. After reading the prompt display, press the Enter key to continue. You are 
shown the Specify Command Defaults display: 
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12. 


13. 


14. 


a > 


Specify Command Defaults 
Type choices, press Enter. 
DEVICOSi ens tates) caesar eses TAPOQ1 Names 
Prompt for commands ..... Ne Y=Yes, N=No 
Check for active files .... Y Y=Yes, N=No 
Message queue delivery... . *BREAK *BREAK, *NOTIFY 
Stanttimes sy ec se es en te *CURRENT *CURRENT, time 
Vary off network servers... *NONE *NONE, *ALL, 
*WINDOWSNT, *GUEST 
Unmount file systems ..... N Y=Yes, N=No 
F3=Exit F12=Cancel More... 
‘e y 
a 
a Specify Command Defaults 
Type choices, press Enter. 
Print system information... N Y=Yes, N=No 
Use system reply list. .... N Y=Yes, N=No 
F3=Exit F12=Cancel Bottom 
= a 


Type your choices for the Devices prompt. You can specify as many as four 
tape media device names. If you specify more than one device, the server 
automatically switches to the next tape device when the current tape is full. 
You may select only one DVD-RAM optical media device. 


The first device for options 21 and 22 should be your alternate IPL device. If 
you are creating media to install on another server, the device must be 
compatible with the alternate IPL device for that server. This ensures that the 
server can read the SAVSYS media if you need to restore your Licensed 
Internal Code and the operating system. 


Type your choice for the Prompt for commands prompt. Specify N (No) if you 
want to run an unattended save. Specify Y (Yes) if you want to change the 
defaults on the SAVxxx commands. 


Note: If Y is specified to change the LABEL parameter for save commands, Y 
must be specified if you use this media to restore the server. 


Type your choice for the Check for active files prompt. Specify Y (Yes) if you 
want the server to warn you if active files exist on the save media. The 
warning you receive gives the following choices: 


* Cancel the save operation. 
* Insert new media and try the command again. 


* Initialize the current media and try the command again. 


Note: If you use DVD-RAM optical media for your save, the server sends 
inquiry messages to the QSYSOPR message queue when it encounters 
identical active files. The server sends the inquiry message for each 
identical active file that it finds. See How optical media is different 
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from tape media} online in the Information Center, or the Optical Support 


book for more information on optical media. 
Specify N (No) if you want the server to write over any active files on the save 
media without warning you. 


15. Type your choice for the Message queue delivery prompt. Specify *NOTIFY if 
you want to do an unattended save. This prevents communications messages 
from stopping the save operation. If you specify *NOTIFY, severity 99 
messages that are not associated with the save operation are sent to the 
QSYSOPR message queue without interrupting the save process. For example, 
messages that request a new volume be loaded interrupt the save operation 
because they are associated with the job. You cannot continue until you reply 
to these messages. 


Specify *BREAK if you want to be interrupted for severity 99 messages that 
require a reply. 

16. Type your choice for the Start time prompt. You may schedule the start of the 
save operation up to 24 hours later. For example, assume that the current time 
is 4:30 p.m. on Friday. If you specify 2:30 for the start time, the save operation 
begins at 2:30 a.m. on Saturday. 


Notes: 

a. The server uses the Delay Job (DLYJOB) command to schedule the save 
operation. Your workstation will be unavailable from the time you request 
the menu option until the save operation completes. 

b. Make sure that your workstation is in a secure location. Your workstation 
remains signed on, waiting for the job to start. If the server request 
function is used to cancel the job, your workstation displays the Save 
menu. The workstation remains signed on with your user profile and your 
authority. 

c. Make sure that the value for the QINACTITV system value is *NONE. If 
the value for QINACTITV is other than *NONE, the workstation will vary 
off in the amount of time specified. If you changed the value to *NONE, 
write the old value down. 

d. If you specify a delayed start and want your save operation to run 
unattended, be sure you have done the following: 


* Set up the system reply list. 

* Specified *NONE on QINACTITV system value. 
* Specified *NOTIFY on message queue delivery. 

* Specify *NOTIFY for any break messages. 

* Responded N to the Prompt for commands prompt. 
* Responded N to Check for active files. 


17. Type your choice for the Vary off network servers prompt. If you use Integration 
for Windows Server, you may vary off the network server descriptions before 
beginning the save procedure. 

Select one of the following options to specify which network servers should 
be varied off before the save operation is performed: 

The Information Center provides additional information about the effects of 
varying off the network servers. Select one of the following options to specify 
which network servers should be varied off before the save operation is 
performed: 
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18. 


19. 


20. 


21. 


*NONE 
Does not vary off network servers. The save operation will take longer 
since the network server data will be saved in a format that allows 
restoration of individual objects. 


*ALL Varies off all network servers. The save operation will take less time 
but the network server data will not be saved in a format that allows 
restoration of individual objects. You will only be able to restore all of 
the data from the network servers. 


*WINDOWSNT 
Varies off all network servers of type *WINDOWSNT prior to the start 
of the save. This allows the save of the network server storage spaces. 


*GUEST 
Varies off all network servers of type *GUEST. Select this option to 
save data on a secondary logical partition with Linux installed on it. 


Note: Linux (*“GUEST) NWSDs that use an NWSSTG as the IPL 
source (IPLSRC(*NWSSTG)) or use a stream file as the IPL 
source (IPLSRC(*STMF)) will be fully saved and restored using 
Option 21. *GUEST NWSDs that use IPLSRC(A), IPLSRC(B), or 
IPLSRC(PANEL) will NOT be able to start on a system restored 
from an Option 21 save and will require additional actions, 
such as booting Linux from the original installation media, to 
be recovered. 


See the Linux in a guest partition topic in the iSeries 
Information Center at 

http:/ /www.ibm.com/eserver/iseries/infocenter for more 
information. 


Type your choice for the Unmount file system prompt. If you use user-defined 
file systems (UDFSs), you should unmount the UDFSs before beginning the 
save procedure. Specify Y (Yes) if you want to allow all dynamically mounted 
file systems to be unmounted. This allows you to save UDFSs and their 
associated objects. IBM recommends that you unmount your UDFSs for 
recovery purposes. For more information on UDFSs, refer to OS/400 Network 
File System Support, SC41-5714-02. 


Note: After the save operation completes, the server will not attempt to 
remount the file systems. 


Specify N (No) if you do not want all dynamically mounted file systems to be 
unmounted. If you specify N, and you have mounted UDF$Ss, you will receive 
a CPFAQ9E message for each mounted UDFS. The objects in the mounted UDFS 
will be saved as if they belong to the mounted over file system. 


Type your choice for the Print system information prompt. Specify Y (Yes) if you 
want to print the system information. The system information may be useful 
for disaster recovery. F oriniting aysten information” orpage Milexplains how 
to print your system information manually without using the automatic GO 
SAVE command menu option function. 


Type your choice for the Use system reply list prompt. Specify Y (Yes) if you 
want to use the system reply list when the server sends an inquiry message. 
Press the Enter key. If you chose a later start time, your display shows 
message CPI3716. The message tells when the save operation was requested 
and when it will start. You cannot use the display until the save operation 
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22. 


23. 


completes. The input-inhibited indicator should appear. You have completed 
the steps for setting up the save operation. 


If you did not choose a later start time, continue with step If the value for 
OSYSOPR message queue delivery is *BREAK with a severity level of 60 or 
lower, you must respond to the ENDSBS messages. This is true even if you 
plan to run an unattended save operation specifying a start time of 
*CURRENT. 


If you responded Y to the system prompt, Prompt for commands, the End 
Subsystem display appears. Type any changes and press the Enter key. While 
the server is ending subsystems, you see the following messages. You must 
respond to them if the QSYSOPR message queue is set to *BREAK with a 
severity level of 60 or lower. Each message appears at least twice. Press the 
Enter key to respond to each message. 


a. CPFO994 ENDSBS SBS(*ALL) command being processed 
b. CPF0968 System ended to restricted condition 


If you responded N to the Prompt for commands prompt, skip to step [24 on] 
When the server is ready to perform each major step in the save operation, 
you are shown the prompt display for that step. The time between prompt 
displays may be quite long. 

For option 21 (Entire system) these prompt displays appear: 


ENDSBS SBS(*ALL) OPTION(*IMMED) 
SAVSYS 
SAVLIB LIB(*NONSYS) ACCPTH(*YES) 
SAVDLO DLO(*ALL) FLR(*ANY) 
SAV DEV('/QSYS.LIB/media-device-name.DEVD') + 
OBJ(('/*') ('/QSYS.LIB' *OMIT) + 
('/QDLS' *OMIT)) + 
UPDHST(*YES) 
STRSBS SBSD(controlling-subsystem) 


For option 22 (System data only) these prompt displays appear: 


ENDSBS SBS(*ALL) OPTION(*IMMED) 

SAVSYS 

SAVLIB LIB(*IBM) ACCPTH(*YES) 

SAV DEV('/QSYS.LIB/media-device-name.DEVD') + 
OBJ(('/QIBM/ProdData') + 

('/QOpenSys/QIBM/ProdData')) + 

UPDHST (*YES) 

STRSBS SBSD(controlling-subsystem) 


For option 23 (All user data) these prompt displays appear: 


ENDSBS SBS(*ALL) OPTION(*IMMED) 
SAVSECDTA 
SAVCFG 
SAVLIB LIB(*ALLUSR) ACCPTH(*YES) 
SAVDLO DLO(*ALL) FLR(*ANY) 
SAV DEV('/QSYS.LIB/media-device-name.DEVD') + 
OBJ(('/*') ('/QSYS.LIB' *OMIT) + 
(‘/QDLS' *OMIT) + 
('/QIBM/ProdData' *OMIT) + 
('/QOpenSys/QIBM/ProdData' *OMIT)) + 
UPDHST (*YES) 
STRSBS SBSD(controlling-subsystem) 


Type your changes at each prompt display and press the Enter key. 
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24. 


25. 


26. 


27. 


28. 


29. 


30. 


When the server sends a message that asks you to load the next volume, load 
the next media and respond to the message. For example, if the message is the 
following, load the next volume and then enter R to retry (C cancels the 
operation): 

Device was not ready or next volume was 

not loaded (C R) 


-— If a media error occurs 


If an unrecoverable media error occurs during the SAVLIB procedure, see 
find this subject under the Backing up your server topic in the 
Information Center. 


After the save completes, you should mount user-defined file systems at this 
point if you unmounted them for the save operations. 


Change the QINACTITV system value back to its original value. You wrote 
this value down in step [l6c on page 24 

When the save operation completes, print the job log. It contains information 
about the save operation. Use it to verify that the operation saved all objects. 


Type one of the following: 
DSPJOBLOG * *PRINT 


Or 
SIGNOFF *LIST 


You have completed the save operation. Make sure that you mark all of your 
media and store it in a safe, accessible place. 


If you ended clustering before running the save operation, restart clustering 
on the save node from a node where clustering is already active. 


For more information, refer to the online help in the Simple Cluster 
Management utility or see the Clusters topic in the iSeries Information Center 
at http: //www.ibm.com/eserver /iseries /infocenter. 

Now restart the device cluster resource group to enable resiliency. 

For more information, refer to the online help in the Simple Cluster 
Management utility or see the Clusters topic in the iSeries Information Center 
at http:/ /www.ibm.com/eserver /iseries /infocenter. 

If you made independent ASPs available before an Option 21 or 23 save, they 
are now in an Active state. To access data you must first make them 
unavailable and then make them available again. 

For more information see the Independent disk pool topic in the iSeries 
Information Center at http://www.ibm.com/eserver /iseries /infocenter. 


Printing system information 

Printing the system information provides valuable information about your server 
that will be useful during a system recovery. It is especially useful if you cannot 
use your SAVSYS media to recover and must use your distribution media. Printing 
this information requires *ALLOBJ, *IOSYSCFG, and *JOBCTL authority and 
produces many spooled file listings. You may not need to print this information 
every time you perform a backup. However, you should print it whenever 
important information about your server changes. 
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1. 


Print your current disk configuration. This is essential if you plan to do a 
model upgrade and you are using mirrored protection. This information is 
also vital if you need to recover an independent ASP. Do the following: 


a. Sign on with a user profile that has *SERVICE special authority. 
b. Type STRSST on a command line and press the Enter key. 


c. Specify the service tools user ID and service tools password. These are 
case-sensitive. 

d. Select option 3 (Work with disk units) on the System Service Tools (SST) 
display. 

e. Select option 1 (Display disk configuration) on the Work with Disk Units 
display. 

f. Select option 3 (Display disk configuration protection) on the Display Disk 
Configuration display. 

g. Print the displays (there may be several) using the PRINT key for each 
display. 

h. Press F3 until you see the Exit System Service Tools display. 

i. On the Exit System Service Tools display, press the Enter key. 


. If you are using logical partitions, print the logical partition configuration 


information. 


a. From the primary partition, type STRSST on a command line and press 
Enter. 


b. If you are using SST, select option 5 (Work with system partitions), and 
press Enter. If you are using DST, select option 11 (Work with system 
partitions), and press Enter. 


c. From the Work With System Partitions menu, select option 1 (Display 
partition information). 


d. To display all system I/O resources from the Display Partition Information 
menu, select option 5. 


e. At the Level of detail to display field, type *ALL to set the level of detail to 
ALL. 


f. Press F6 to print the system I/O configuration. 

g. Select option 1 and press Enter to print to a spooled file. 

h. Press F12 to return to the Display Partition Information menu. 
i. Select option 2 (Display partition processing configuration). 


j. From the Display Partition Processing Configuration display, Press F6 to 
print the processing configuration. 


k. Press F12 to return to Display Partition Information display. 

I. Select option 7 (Display communications options). 

m. Press F6 to print communication configuration. 

n. Select option 1 and press Enter to print to a spooled file. 

o. Return to an OS/400 command line and print these three spooled files. 


. If you are operating in a clustered environment, print the cluster configuration 


information. Use the following commands to print cluster information: 
a. Display Cluster Information — DSPCLUINF DETAIL(*FULL) 


b. Display Cluster Resource Group — DSPCRG CLUSTER (cluster-name) 
CLU(*LIST) 


. If you have independent ASPs configured, record the relationship between the 


independent ASP name and number. You can find this information in iSeries 
Navigator. In the Disk Units folder, select Disk Pools. 
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5. Sign on with a user profile that has *ALLOBJ special authority, such as the 
security officer. The server lists information only if you have the proper 
authority. If you sign on as a user with less than *ALLOBJ authority, some of 
the listings in these steps may not be complete. You must also be enrolled in 
the system directory before you can print a list of all the folders on the server. 


6. If you use the history log or if you have a requirement to keep it, do the 


following: 


a. Display the system log QHST. This automatically brings it up to date. 


Type: 


DSPLOG LOG(QHST) OUTPUT (*PRINT) 
b. Display all copies of the system log: 
WRKF FILE(QSYS/QHST*) 


Look at the list to verify that you saved all copies of the log that you may 
need later. 


Note: The history (QHST) log contains information such as date created, 
and the last change date and time. To get more information about 
the history (QHST) log, select option 8 (Display file description) on 
the Work with Files display. 


c. To prevent confusion about the date of the log, select the Delete option on 
the Work with Files display. Delete all but the current copies of the system 
log. This step improves the performance of the SAVSYS command. 


7. Print the system information. You can do this by two different methods: 


a. Using the GO SAVE command, on the Specify Command Defaults display, 
select Y at the Print system information prompt. 


b. Use the PRTSYSINF command. 


The following table describes the spooled files that the server creates. The 
PRISYSINF command does not create empty spooled files. If some objects or 
types of information do not exist on your server, you may not have all of the 
files listed below. 


Table 2. Spooled Files Created by the server 


Spooled File User Data Description of Contents 

Name 

QPEZBCKUP DSPBCKUPL List of all user libraries 

QPEZBCKUP DSPBCKUPL List of all folders 

QSYSPRT DSPSYSVAL Current settings for all system values 

QDSPNET DSPNETA Current settings for all network attributes 

QSYSPRT DSPCFGL Configuration lists 

QSYSPRT DSPEDTD User-defined edit descriptions ( a separate spooled 
file for each) 

QSYSPRT DSPPTF Details of all fixes that are installed on your server 

OPRTRPYL WRKRYPLE All reply list entries 

OQSYSPRT DSPRCYAP Settings for access path recovery times 

QSYSPRT DSPSRVA Settings for service attributes 

OSYSPRT DSPNWSSTG Network server storage spaces information 

QSYSPRT DSPPWRSCD Power on/off schedule 
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Table 2. Spooled Files Created by the server (continued) 


Spooled File User Data Description of Contents 

Name 

QSYSPRT DSPHDWRSC Hardware configuration reports (a separate spooled 
file for each resource type, such as *CMN or *LWS) 

OSYSPRT WRKOPTCFG Optical device descriptions (if your server has an 
optical device and optical support is started when 
you run the command) 

OSYSPRT DSPRJECFG Remote job entry configurations 

OPDSTSRV DSPDSTSRV SNADS configuration 

QPRTSBSD DSPSBSD Subsystem descriptions (a separate spooled file for 
each subsystem description on your server) 

QSYSPRT DSPSFWRSC Installed licensed programs (Software Resources 
List) 

QPRTOBJD DSPOBJD A list of all the journals on your server 

QPDSPJNA WRKJRNA The journal attributes for each journal that is not in 
the QUSRSYS library (a separate file for each 
journal). Typically, journals in the QUSRSYS library 
are IBM-supplied journals. If you have your own 
journals in the QUSRSYS library, you need to 
manually print information about those journals. 

OSYSPRT CHGCLNUP Settings for automatic cleanup 

QPUSRPRF DSPUSRPRF Current values for the QSECOFR user profile 

QPRTJOBD DSPJOBD Current values for the QDFTJOBD job description 

QPJOBLOG PRTISYSINF The job log for this job! 

2 On your server, this spooled file might be in the QEZJOBLOG output queue. 


8. Print a list of directories in the root directory. 
DSPLNK OBJ('/*') OUTPUT (*PRINT) 


9. Print any IBM-supplied objects that you have modified, such as the QSYSPRT 
print file. 


10. If you maintain a CL program that contains your configuration information, 
use the Retrieve Configuration Source (RTVCFGSRC) command to ensure that 
the CL program is current. 

RTVCFGSRC CFGD(*ALL) CFGTYPE(*ALL) + 
SRCFILE(QGPL/QCLSRC) + 
SRCMBR(SYSCFG) 

11. Print these spooled files. Keep this information with your backup log or your 
save system media for future reference. If you choose not to print the lists, use 
the Copy Spooled File (CPYSPLF) command to copy them to database files. 
See the Information Center for information on how to do this. Make sure that 
the database files are in a library that is saved when you perform the Save 
menu option. 


Go to}|“Use GO SAVE: Options 21, 22, and 23” on page 21 


Using the ObjectConnect/400 Function 


ObjectConnect/400 is a set of CL commands for moving objects between iSeries 
servers simply and efficiently. ObjectConnect/400 is included with the operating 
system. You install it by selecting it on the Install Licensed Program display. 
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When you use an ObjectConnect command, the system moves the object directly to 
the target system without using save files or distribution queues. ObjectConnect 
provides better performance than other methods for moving objects between 
systems, and ObjectConnect does not require additional disk space to store an 
intermediate copy of the object that is being moved. 


ObjectConnect commands are closely related to the SAVxxx and RSTxxx 
commands. The ObjectConnect commands support most of the same parameters. 


Table 3} shows a list of the ObjectConnect commands and the associated iSeries 
save and restore commands. |“Using the ObjectConnect Commands” on page 34 
describes the functions that are performed by each command. The online command 


help describes the parameters for each command. 


Table 3. ObjectConnect/400 and Associated iSeries Save and Restore Commands 


ObjectConnect Commands iSeries Save and Restore Commands 


Save/Restore Integrated File System (SAVRST) Save (SAV), Restore (RST) 


Save/Restore Object (SAVRSTOBJ) Save Object (SAVOBJ), Restore Object 
(RSTOBJ) 

Save/Restore Changed Object (GSAVRSTCHG) Save Changed Object (GAVCHGOB)J), 
Restore Object (RSTOBJ) 

Save/Restore Library (SAVRSTLIB) Save Library (SAVLIB), Restore Library 
(RSTLIB) 

Save/Restore Document Library Object Save Document Library Object 

(SAVRSTDLO) (SAVDLO), Restore Document Library 
Object (RSTDLO) 

Save/Restore Configuration (GAVRSTCFG) Save Configuration (SAVCFG), Restore 


Configuration (RSTCFG) 


To use the ObjectConnect functions, you must have ObjectConnect installed on 
both the source and target systems. The systems must be connected with one of 
the following methods: 


¢ Local area network (LAN) or remote communications linewith APPC and 
APPN*. 


¢ Local area network (LAN) or remote communications line with TCP/IP with 
AnyNet* support. 


* Fiber optic bus with OptiConnect/400. 


Components of ObjectConnect/400 


The basic components of ObjectConnect/400 are outlined below: 


Component Description 
QSR library This library contains all ObjectConnect objects. 
QCMN subsystem If the source and target systems are connected with a 


communications line or a LAN, ObjectConnect jobs run in the 
QCMN subsystem. 

QSOC subsystem If the source and target systems are connected with 
OptiConnect/400, ObjectConnect jobs run in the QSOC 
subsystem. 

QSOCCT mode description ObjectConnect uses the IBM-supplied default mode description, 
QSOCCT. You must start this mode description before you use 
ObjectConnect commands by specifying the following: 


STRMOD RMTLOCNAME(target) MODE(QSOCCT) 
LCLLOCNAME(*NETATR) RMTNETID(*NETATR) 
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Component Description 


QUSER user profile This IBM-supplied user profile is used by ObjectConnect jobs. 


Setting Up Your System to Use ObjectConnect/400 


After you have installed ObjectConnect, you must set up your systems to run 
ObjectConnect. You perform some tasks only once. You perform other tasks 
regularly to prepare for ObjectConnect commands. 


Do These Things Initially: If your systems are connected with a communications 
line or a LAN, add a communications entry to the QCMN subsystem. Type the 
following on both systems: 


ADDCMNE SBSD(QCMN) DEV(*ALL) DFTUSR(QUSER) 
MODE (QSOCCT) 


If you are using a fiber-optic bus, see the OptiConnect for OS/400 book. 


Do These Things Before You Run ObjectConnect Commands: Whenever you start 
your system, you must also start the ObjectConnect environment. You can include 
these tasks in your startup procedures, or you can perform them manually. 


If your systems are connected with a communications line or a LAN, do the 
following: 


* Ensure that the QCMN subsystem is started. 
* Ensure that the connection is varied on and active. 
* Start the mode description by typing the following: 


STRMOD RMTLOCNAME(target) MODE(QSOCCT) 
LCLLOCNAME(*NETATR) RMTNETID(*NETATR) 


If your systems are connected with OptiConnect/400, continue with ‘How the] 
System Runs an ObjectConnect Command)’. 
How the System Runs an ObjectConnect Command 


When you issue an ObjectConnect command, the system starts an ObjectConnect 
job and establishes a conversation with the target system. |Figure 3 on page 33 
shows the flow of the job: 


32 OS/400 Backup and Recovery V5R2 


;__— SAVRSTxxx command issued 
Source Target 
System System 
Optical Bus 
Interface Optical Bus 
conversation 
Optical Bus completed 
support a 
starts Optical Bus 
conversation connection 
and dialog 
—Machine established Machine 
Interface Interface 
v 
_p Save data Restore data 
transferred Berenied 


Optical Bus connection 
RBANS507-0 


Figure 3. ObjectConnect Job Flow 


You can view the ObjectConnect job by working with the subsystem. Type 
WRKACTJOB SBS(QCMN) if your systems are linked with communications support. 
Type WRKACTJOB SBS(QSOC) if your systems are linked with OptiConnect/400. You 
are shown the Work with Active Jobs display: 


( Work with Active Jobs AS0Q09 


03/31/95 


CPU % .0 Elapsed time: 00:00:00 Active Jobs 60 


Type options, press Enter. 
2=Change 3=Hold 4=End 5=Work with 6=Release 7=Display messages 
8=Work with spooled files 13=Disconnect ... 


Opt Subsystem/Job User Type CPU % Function Status 
QCMN QSYS SBS 0 DEQW 
S ENDCTL1 QCMN BCH 0 DEQW 
RCHCTL2 QCMN ASJ .0 PGM-QYYCMGR  DEQW ) 
You can use the Work with Configuration Status (WRKCFGSTS) command to see 
the activity on the communications or LAN link: 
( Work with Configuration Status AS009 : 
03/31/95 
Position to: 2s. 2 s Starting characters 
Type options, press Enter. 
l=Vary on 2=Vary off 5=Work with job 8=Work with description 
9=Display mode status ... 
Opt Description Status wenn nnnn--- Job------ 
WWGLOCAL ACTIVE 
WWGLOC1 ACTIVE 
= QSOCCT ACTIVE/DETACHED QPADEVQ023 GREEN 
QSOCCT ACTIVE/SOURCE QPADEVQ024 GREEN ) 
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Using the ObjectConnect Commands 


The following topic shows the specific functions that are performed by the 
ObjectConnect commands. You can use the Remote Location Name 
(RMTLOCNAME) parameter on these commands to specify where the saved 
objects in directories are to be restored. The system determines the method 
(communications line or optical connection) for transferring data to that location. 
ObjectConnect cannot run in restricted state. 


Save/Restore (SAVRST) Command 

You can use the Save/Restore (SAVRST) command to save one or more objects in 
directories, send them to another system, and restore them. It can also save entire 
directories (not to be confused with entire systems). The SAVRST command 
supports the same options as the SAV command. 


Save/Restore Object (SAVRSTOBJ) Command 

You can use the Save/Restore Object (SAVRSTOBJ) command to save one or more 
objects, send them to another system, and restore them. The SAVRSTOBJ command 
supports the same options as the SAVOBJ command, including the use of the 
OMITOBJ parameter. 


Save/Restore Change Objects (SAVRSTCHG) Command 

You can use the Save/Restore Changed Objects (GSAVRSTCHG) command to save 
one or more changed objects, send them to another system, and restore them. An 
example of this would be a situation where you wanted to maintain duplicate sets 
of files on two different systems. The SAVRSTCHG command supports most of the 
same options as the SAVCHGOBJ command, including use of the OMITOBJ 
parameters. You may use the OMITLIB parameter with this command, and you 
may also specify generic values for the LIB parameter on this command. 


Save/Restore Library (SAVRSTLIB) Command 

You can use the Save/Restore Library (SAVRSTLIB) command to save one or more 
libraries, send them to another system, and restore them. The SAVRSTLIB 
command supports the same options as the SAVLIB command, including the use 
of the OMITLIB and OMITOB] parameters. You may also use generic values for 
the *LIB parameter on this command. 


Save/Restore Document Library Object (SAVRSTDLO) Command 
You can use the Save/Restore Document Library Object (GAVRSTDLO) command 
to save one or more document library objects, send them to another system, and 
restore them. The SAVRSTDLO command supports the same options as the 
SAVDLO command. 


Save/Restore Configuration (SAVRSTCFG) Command 

You can use the Save/Restore Configuration (GAVRSTCFG) command to save one 
or more configuration objects, send them to another system, and restore them. The 
SAVRSTCFG command supports most of the options and parameters as the 
SAVCFG and RSTCFG commands. 


When you copy your configuration by using the SAVRSTCFG command, the 
system saves and restores the following object types: 


*CFGL *CNNL *CRGM *NTBD 


*CIO *COSD *MODD *TRA 
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Investigating ObjectConnect Problems 
If all ObjectConnect commands are failing, do the following: 
* Ensure the correct subsystem is active. 
* Ensure the connection between systems is active. 
* Ensure the correct remote location name is specified. 


If you suspect a more specific problem, do the following: 


1. Locate the failing job or job log on both the source and target system. An 
informational message may exist between the save completion message and the 
restore completion message. This message ID is CPFAD87. If this message 
exists, use F1 to display the detailed message to determine the name of the job 
log on the target system. 


2. Display the job log information on the target system and find the following 
message: 


Corresponding source information from location &1; 


3. Use F1 to display the detailed message. The detailed information indicates the 
job name and number for the source job. 


4. Inspect the job log information on both systems to locate any messages. The 
messages each include secondary text that describes the recommended course 
of action if one is needed. 


If problems are identified as OptiConnect/400 or communications problems, see 
the OptiConnect/400 Guide or the Communications Configuration book. 


CPFAD84 Error Codes 


If you receive a CPFAD84 message on either the source or target system, refer to 
the error codes below to identify the problem. You may also use the Analyze 
Problem (ANZPRB) command to report the problem. 


Source System-specific Error Codes from CPFAD84 Message 


SRC1 Unknown message type was received on the source system, sent from 
target system. ObjectConnect does not expect the target system to send 
messages other than escape, completion, diagnostic, or information type 
messages. 


SRC2 Zero messages sent from target system. ObjectConnect expects to get a 
minimum of one message that indicates success or failure. If the target 
system does not send any messages, then this is an error. 


SRC3_ Receive response above MI sent an invalid code within the message. This 
indicates that something on the target system failed and could not 
continues. Check the spool file on the target system. 


SRC4 Cannot start save operation. Save code has sent an escape message, 
indicating its inability to begin the save operation. This may be a source 
type problem or a sink type problem. Check for vlogs and try again. The 
number of simultaneous save operations or restore operations may have 
exceeded the allowable limit. 


Target System-specific Error Codes from CPFAD84 Message 


TGT1 Spool file is invalid. This indicates that the spool file had messages in an 
order that are not expected. This error may also occur if ObjectConnect 
information message CPFAD85 is not in the spool file. 


TGT2_ Received a ‘terminate’ message from below MI on source system. This is 


Chapter 2. Saving your Server 35 


running over bus only. This indicates that the source has ended for some 
reason and that it has notified the target system that it will not send any 
more data. Refer to the source system job log. 


TGT3 Send Response failed after Receive Request worked. Target system received 
a function check while running via the bus. 


TGT4 Received a function check while running via the bus, and did not receive 
any information from the source system. 


TGT5 Cannot start restore operation. Restore code has sent an escape message, 
indicating its inability to begin the restore operation. This may be a source 
type problem or a sink type problem. Check for vlogs and try again. The 
number of simultaneous save operations or restore operations operations 
may have exceeded the allowable limit. 


Source or Target system Error Codes from CPFAD84 Message 


F4BE Sent from below MI. This indicates that a valid ending of the job has 
occurred. For example, the source system begins the save operation by 
using the SAVRSTOBJ command. If it finds that there is no data to save in 
the library, it returns a message that indicates that no objects were saved. 
The source system sends a message to the target system indicating that no 
data is being transferred. The job on the target system ends instead of 
waiting for the data. 


FxBF Received invalid error message from below MI. This can be received in the 
CPF389C error message. This is never an expected.error code. Check for 
vlogs and try the request again. 


0000) =Although this would usually indicate a valid function or return code, in 
this situation it indicates that something out of the ordinary has failed. If 
running via the bus, the bus manager has completed its operation in a 
valid state, but something else has failed. Try the request again. 
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Part 3. Recovering Information on Your System 


Chapter 3. Restore Procedures—General 

Information . 

The Relationship Between Save and Restore 

Commands ; : 

What Happens When You Restore Objects ‘ 

Sequence for Restoring Related Objects . 

Putting Your System in a Restricted State 

Reclaiming Storage . : 

How to Reclaim Storage . : 
Controlling Restoration of Security- Sensitive Objects 
How to Set the QPFRADJ System Value for a 
Different Processor or Memory . 

Locked Objects While Restoring : 

How to Verify That Objects Are Restored 

Successfully : 

Recovery from an Unsuccessful Restore Operation 
Recovering from an Error While Restoring 
Libraries 
Recovering a an — ‘While Restoring DLOs 

Recovering OfficeVision® Mail . 
Recovering Documents and Folders 

How to Perform™ a Normal IPL 

Parallel Restore Operations . 

Recovery Considerations for Cryptographic Access 

Provider 


Chapter 4. Selecting the Right Recovery Strategy 
Some Common Recovery Terminology 
Recovery Procedure for a Power Failure . 
Recovery Procedure for a System Failure 
Recovery Procedure for a Program Failure or 
Human Error. 
Choosing the Recovery Procedure for a Disk Failuse 
or Disk Errors : : 
Actions for load source disk “init 
failure—Checklist 1 . : ; 
Actions for load source disk iinie 
failure—Checklist 2 . : : 
Actions for load source disk ant 
failure—Checklist 3 . ; : 
Actions for load source disk anit 
failure—Checklist 4 . : 
Actions for load source disk aide 
failure—Checklist 5 . : 
Actions for non-load source disk unit ‘failure or 
disk units in basic user ASP disk 
failure—Checklist 6 . ; : 
Actions for non-load source dizk sande 
failure—Checklist 7 . : : 
Actions for non-load source disk find 
failure-Checklist 8 . : : 
Actions for non-load source disk ‘inde 
failure-Checklist 9 . . : 
Actions for non-load source disk uni 
failure—Checklist 10. 
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Chapter 3. Restore Procedures—General Information 
shows the menu options and commands that are available for 


restoring information. It also shows the normal sequence for restoring information, 
working from top to bottom. |Figure 5 on page 43|/shows what restore commands 
can be used for information in the different file systems. 


Note: Look for comprehensive information about how to save your iSeries server 
o Wy 


on the Information Center. |“Prerequisite and related information” on page xv 
explains how to access the Information Center. 


Compare these figures with the save information on the Information Center to see 
the relationship between how things are saved and how they are restored. Use 


them to gain a general understanding of what you need to restore and how you 
might do it. Use the information in|Chapter 4, “Selecting the Right Recove 
Birategy’] 


‘|to plan the correct recovery strategy for your situation. 
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Procedure for Restoring 
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| i} 
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23 P 
IK Configuration Objects RSTCFG 
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© QXXXxx RSTLIB 
> < *NONSYS 
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RSTLIB 
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¢ LIBA 
e LIBB 
e LIBC 
e LIBxxx 4 < 
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Filed Documents and Folders RSTDLO 
Distribution Objects ld 
> User Objects in Directories < RST 
Saved Changes in Libraries, RSTLIB, RSTOB4J, RSTDLO, RST 
Documents, and Directories 
Journaled Changes Mg APYJRNCHG 
ALL Private Authorities p RSTAUT 
> 


RBANS508-0 


Figure 4. Restore Procedures 


Note: RSTOBJ can also be used where RSTLIB is shown to restore objects. 
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SAVSYS, SAVCFG, Chapters 12 and 13 
SAVSECDTA, QSYS.LIB RSTUSRPRF, RSTAUT 
SAVLIB, SAVOBJ, (Library) RSTCFG, RSTLIB, 
SAVCHGOBJ, SAV RSTOBJ, RST 
SAVDLO QDLS RSTDLO 
SAV (Document library RST 

services) 
SAV OOpenSys RST 


(Open systems) 


SAV QNetware RST 
(OS/400 Integration 
for Novell Netware) 


SAV Domino server data RST 
directory 
(Domino for iSeries) 


SAV User-defined RST 
file systems 
(/dev/QASPxx) or 
(/dev/aspname/) 

SAV (Other file systems) RST 

SAV Root RST 


RBANSS501-1 


Figure 5. Save procedures and restore procedures for file systems 


The Relationship Between Save and Restore Commands 


‘Table 4) shows which restore commands can be used, based on how the objects 
were saved. 


Note: For comprehensive information on saving your server, refer to the Backing 
up your system topic on the Information Center at the following Web site: 


http://www. ibm.com/eserver/iseries/infocenter 


This Web site includes general information on the save commands below. 


Table 4. Relationship Between Save and Restore Commands 


Save Command Used Possible Restore Command 
SAVOBJ RSTOBJ 

RST 
SAV RST 
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Table 4. Relationship Between Save and Restore Commands (continued) 


Save Command Used Possible Restore Command 


SAVLIB LIB(#*NONSYS) RSTLIB SAVLIB(*NONSYS) 
RSTLIB SAVLIB(*IBM) 
RSTLIB SAVLIB(*ALLUSR) 
RSTLIB SAVLIB(library-name) 


RST 

SAVLIB LIB(*ALLUSR) RSTLIB SAVLIB(*ALLUSR) 
RSTLIB SAVLIB(library-name) 
RST 

SAVLIB LIB(*IBM) RSTLIB SAVLIB(*IBM) 
RSTLIB SAVLIB(library-name) 
RST 

SAVLIB LIB(library-name) RSTLIB SAVLIB(library-name) 
RST 

SAVSECDTA RSTUSRPRF 
RSTAUT" 

SAVCFG RSTCFG 

SAVSYS Restore Licensed Internal Code. (See 


Chapter 5}) 
Restore operating system. (See|Chapter 6}) 


RSTUSRPRF 
RSTCFG 
RSTAUT' 

SAVDLO RSTDLO 
RST 


The RSTUSRPRF command restores authority information to temporary tables. The 
RSTAUT command regrants private authorities using tables that are built as a part 
of the RSTUSRPRF command. 


What Happens When You Restore Objects 


An object on this system is like a container. The object has information about the 
container itself, such as the owner of the object and the last time it was saved. This 
is the information you see when you display the object description (DSPOBJD 
command). The object also has contents, such as the records in a database file or 
the instructions in a program. 


When you restore an object, the system takes different actions depending on the 
following: 


* Whether the object to be restored already exists. 
* The allow object differences (ALWOBJDIF) parameter on the restore command. 


* Whether the object was saved on a different system (serial number of the 
processor). 


With a few exceptions that relate to security, the contents of the object are always 
restored. If the object exists, the system compares the object description 
information on the system copy and the media copy and then makes decisions. For 
most information, the media version of the information is restored. For 
security-relevant information, such as the public authority and the object owner, 
the system version is left unchanged. In a few cases, such as the size of the object 
and the date it was restored, the system determines a value when the object is 
restored. 
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The allow object differences (ALWOBJDIF) parameter on the restore commands is 
primarily for security protection and integrity protection. For example, if system 
security is important to you, you may want to take special action if someone 
attempts to restore an object whose owner has been changed. Or, if the member 
information about a database file does not match, you may have problems with the 
integrity of your data. You can use the ALWOBJDIF parameter to prevent this. 


The default value for the ALWOBJDIF parameter is *NONE. This means that if 
important differences exist between the media version and the system version of 
an object, you want the system to take special action. Normally, you should use the 
default value. However, when you are restoring your information to a different 
system, such as during a disaster recovery, you should specify ALWOBJDIF(*ALL). 
fable 3 shows examples of the effect of the ALWOBJDIF parameter: 


Table 5. Restoring Objects with ALWOBJDIF. Effect of ALWOBJDIF parameter when the 
value on the media and on the system are different. 


Object Characteristic ALWOBJDIF(*NONE) 


That Differs 


Value for Object after Restore Operation 


Specified 


ALWOBJDIF(* ALL) 
Specified 


ALWOBJDIF(*FILELVL) 


Specified 


Object owner 


Object is not restored 


Object primary group Object is not restored 


Object auditing 


Existing value 


Authorization list, restore over existing object: 


Object on media is 
secured by an 
authorization list and 
object on system is 
not secured by an 
authorization list 
Object on media is 
not secured by an 
authorization list and 
object on system is 
secured by an 
authorization list 
Object on media is 
secured by an 
authorization list and 
object on system is 


secured by a different 


authorization list 


Object is not restored 


Object is restored and 
is secured by 
authorization list of 
object on system 


Object is not restored 


Authorization list, new object restored: 


Object is restored 
onto different system 
than it was saved 
from 


Database files: 


Object is restored and 
is not secured by an 
authorization list 


Existing value! 
Existing value® 
Existing value 


Object is restored and 
is secured by 
authorization list of 
object on system” 


Object is restored and 
is secured by 
authorization list of 
object on system?” 


Object is restored and 
is secured by 
authorization list of 
object on system; 
message is sent to 
user? 


Object is restored and 
is secured by the 
same authorization 
list that secured the 
object when it was 
saved, if the 
authorization list 
exists” 


Object is not restored 
Object is not restored 
Existing value 


Object is not restored 


Object is restored and 
is secured by 
authorization list of 
object on system 


Object is not restored 


Object is restored and 
is not secured by an 
authorization list 


Chapter 3. Restore Procedures—General Information 


45 


Table 5. Restoring Objects with ALWOBJDIF (continued). Effect of ALWOBJDIF parameter 
when the value on the media and on the system are different. 


Value for Object after Restore Operation 


Object Characteristic ALWOBJDIF(*NONE) ALWOBJDIF(*ALL) 


That Differs 


Specified 


Specified 


ALWOBJDIF(*FILELVL) 


Specified 


Creation date for file 


Creation date for 
member 


Physical file data 
Level identifier for 
file 


Level identifier for 
member 


* Also applies to RST command with ALWOBJDIF(*OWNER) 

= Also applies to RST command with ALWOBJDIF(*AUTL) 

8 Also applies to RST command with ALWOBJDIF(*PGP) 

. Only applies to RSTLIB and RSTOBJ commands with 
ALWOBJDIF(*FILELVL) 


File is not restored 


Member is not 
restored 


Physical file data is 
not restored 


Physical file data is 
not restored 


File is renamed on 
the system; copy is 
restored from media 
with media creation 
date; message is sent 
to user. 

Member is renamed 
on the system; copy 
is restored from 
media with media 
creation date; 
message is sent to 
user. 


File is renamed on 
the system; copy is 
restored from media 
with media creation 
date; message is sent 
to user. 

Member is renamed 
on the system; copy 
is restored from 
media with media 
creation date; 
message is sent to 
user. 


Logical file is not 
restored. System 
attempts to restore 
physical file data* 


Logical member is 
not restored. System 
attempts to restore 
physical member 
data* 


System attempts to 
restore physical file 
data* 


System attempts to 
restore physical 
member data* 


The following topics provide more information about the effect of the ALWOBJDIF 


parameter: 


* |“How the System Establishes Ownership for Restored Objects” on page 226 
¢ |“How the System Establishes the Authorization List for a Restored Object” on 


° ing File Attributes during 


a Restore Operation” on 


* |“How the System Restores Programs” on page 260 


Sequence for Restoring Related Objects 


Some objects depend on other objects. When related objects are in the same library 
or directory, the system restores them in the correct order. If related objects are in 
different libraries or directories, you must restore them in the correct order or 
perform additional recovery steps after they are restored. 
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If possible, restore objects in this sequence: 


* Journals before journaled objects. If you restore a journaled object when the 
journal is not on the system, you must start journaling again after the journal is 
restored. Use the STRJRNPF command, the STRJRNAP command, the 


STRJRNOBJ command, or the STRJRN command. See}“Restoring Objects That 
[are Joumaled” on page 2 


re Journaled” on page 243)for more information. 


* Journals before journal receivers. If you restore a journal receiver when the 
journal is not on the system, you must associate the journal receivers with the 


journal after it is is restored. Use the WRKJRN command. See|’ Restoring] 

* Physical files before logical files. You_cannot restore a logical file if the based-on 
physiol tlesare token ‘helaysiem 
pace ot desctibes how to restore logical files and based-on physical files that 
are in different libraries. 


Putting Your System in a Restricted State 


Many recovery procedures require that your system have no other activity on it. 
When no subsystems except the controlling subsystem are active on your system, it 
is in a restricted state. 


Use the End Subsystem (ENDSBS) command to put your system in a restricted 
state. You specify how you want the subsystems to end: 


Possible Values for the OPTION Parameter of the ENDSBS Command: 

*CNTRLD Allow active jobs to end themselves (if they are checking 
to see if the job is being ended). If you specify *CNTRLD, 
you can use the delay parameter to set a time for the 
system to wait before ending subsystems immediately. 

*IMMED End the subsystem immediately. Use this option if there 
are no users on the system and no batch jobs running. 


Note: Even if you have no activity on the system, jobs may be running under a 
few system-provided subsystems, such as the QSYSWRK (subsystem 
monitor) subsystem and the QCALSRV (calendar server) subsystem. You can 
endall subsystems immediately without first ending these jobs. You will 
receive messages that these subsystems ended abnormally. 


Do the following to put your system in a restricted state: 

1. Before putting your system in a restricted state, ensure that all users are signed 
off and all jobs are ended. 

2. To receive notification that the subsystems have ended, type the following and 
press the Enter key: 


CHGMSGQ MSGQ(QSYSOPR) DLVRY (*BREAK) 
SEV (60) 


3. To end all subsystems, type the following: 


ENDSBS SBS(*ALL) OPTION(*CNTRLD) 
DELAY (600) 


Note: For the delay parameter, specify a number of seconds that allows your 


system time to bring most jobs to a normal end. On a large, busy system, 
you may need a longer delay. 
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A message is sent that indicates that the procedure for ending subsystems is in 
progress. A final message is sent when the system is in a restricted state. 


Reclaiming Storage 


Use the reclaim storage procedure (RCLSTG command) to recover the 
addressability of lost or damaged objects. This allows you to identify and then 
restore those objects that were damaged. If an authorization list is found damaged 
during reclaim storage, the objects secured by the damaged authorization are 
associated with the system authorization list QRCLAUTL. To find out how to 
recover from damaged authorization lists, look under the Programming topic on 
the Information Center at the following Web 

site:http:/ / www.ibm.com/eserver/iseries /infocenter. 


The RCLSTG command has three parameters, SELECT, OMIT, and ASPDEV. These 

parameters allow you to perform reclaim functions in one of the following ways: 

* All reclaim functions are performed 

* The database cross-reference table reclaim function is performed 

* All reclaim functions are performed, except for the database cross-reference table 
reclaim function 

* Reclaim the system ASP and all basic ASPs.The system ASP has an ASP number 
of 1. Basic ASPs have ASP numbers of 2 through 32. 


* Reclaim a specific independent ASP. Independent ASPs have a device name and 
a number greater than 32. 


Note: The RCLSTG procedure requires auxiliary storage. If you are already using a 
very high percentage of auxiliary storage, the RCLSTG procedure may not 
complete successfully. 


How to Reclaim Storage 

To reclaim storage, do the following: 

1. Sign on the system with a user profile that is authorized to the RCLSTG 
command. Either sign on at the console or use the Transfer Job (TFRJOB) 
command to transfer your job to the controlling subsystem. 

2. Type DSPSYSVAL QALWUSRDMN. If the current value does not include the QRCL 
(Reclaim Storage) library or does not specify *ALL, use the CHGSYSVAL 
command to add QRCL to the list of libraries for this system value. Write the 
current value here: 


3. Type DSPSYSVAL QCTLSBSD to display the name of your controlling subsystem. 
Write the current value here: 


4. If you are reclaiming storage for system and basic ASPs, ensure your system is 
in_a restricted state. To obtain a restricted state, follow the procedure in 


“Putting Your System in a Restricted State” on page 47} If you are reclaiming 


storage for an independent ASP, you must make sure the independent ASP is 
available first; a restricted state is not required for independent ASPs. 


5. Start the reclaim storage process by typing one of the following: 


RCLSTG Reclaim storage of the entire system. 
RCLSTG Reclaim storage of the database cross-reference table. 
SELECT(*DBXREF) 


RCLSTG OMIT(*DBXREF) | Reclaim storage of the entire system except the database 
cross-reference table. 
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RCLSTG Reclaim the system ASP and all basic ASPs 
ASPDEV(*SYSBAS) 
RCLSTG Reclaim a single independent ASP. Enter the name of the 


ASPDEV (auxiliary-storage- 
pool-device-name) 


device description for the independent ASP. Make sure the 
independent ASP is available before you begin the reclaim 
storage process. RCLSTG requires that the independent ASP is 
not in use by other jobs. 


RCLSTG ASPDEV 
(auxiliary-storage-pool-group- 
name) 


Reclaim the primary ASP and all the secondary ASPs within 
the ASP group. The name of any ASP within the ASP group is 
accepted. Primary and secondary ASPs have ASP numbers 
greater than 32. Make sure the independent ASP group is 
available before you begin the reclaim storage process. RCLSTG 
requires that the independent ASP is not in use by other jobs. 
You can submit multiple jobs, each performing RCLSTG on a 
different ASP group, to reclaim multiple ASP groups in parallel. 


6. Use the CHGSYSVAL command to set the QALWUSRDMN system value back 
to its original setting. (You wrote the setting in step 2.) 


7. When the reclaim storage procedure finishes, start the controlling subsystem by 


typing the following: 


STRSBS SBSD(controlling-subsystem) 


(You wrote the name of the controlling subsystem in step 3.) 


What Happens When You Reclaim Storage: The purpose of the RCLSTG command 


is to ensure the following: 


* Objects that reside permanently in auxiliary storage can be accessed. 


* All auxiliary storage either is used properly or is available for use. 


The system checks every object that resides permanently in auxiliary storage for 
loss or damage. It does the following: 


* If an object does not address a library or directory, it is placed in an 
IBM-supplied library or directory based on the object type. The system may not 
be able to retrieve description information for the object, such as: 


— Program temporary fix (PTF) status. 


— Save and restore information. 


— Object attributes and text description. 


* For objects that normally reside in libraries (the QSYS.LIB file system), the 
system does the following: 


— Ifa lost object with the same name and object type is already in the Recovery 
(QRCL) library, the system gives the object that it has just encountered a new 
name. The name has the format QRCLnnnnnn, where nnnnnn is a unique 
number. The original object name is placed in the text description for the 
object in the QRCL library. 


Note: You cannot rename journals and journal receivers. If the system 
encounters two journals (or journal receivers) with the same name and 
they both need to be placed in the QRCL library, the system renames 
one of them. You cannot rename that journal or journal receiver back to 
its original name. You must restore a previous version with the correct 
name or re-create the journal or journal receiver. For this reason, you 
should use a naming convention for journals and journal receivers that 
is unique for the entire system, not just for a library. 
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— If data exists for a lost physical file, the system attempts to rebuild the file 
and place it in the QRCL library. Independent ASPs have their own unique 
ORCL library. The text description for the object in the QRCL library indicates 
that it has been rebuilt. 


To use the physical file, create it again in the correct library with the correct 
attributes. Then copy the data from the rebuilt file in the QRCL library to the 
new physical file. The data in the file may not be complete. 


— Auser domain object can be placed in the QRCL library only if the 
QALWUSRDMN system value includes QRCL or specifies *ALL. Otherwise, a 
lost user domain object is deleted. Most objects are system domain objects. 
User domain objects have type *USRSPC, *USRIDX, or *USRQ. 


— If an object does not have an owner, it is assigned to an IBM-supplied user 
profile based on the object type. Most objects are assigned to the QODFTOWN 
user profile. 


— If descriptions for objects in a library cannot be accessed, the library is rebuilt. 


— If an object is secured by a damaged authorization list or authority holder, the 
system makes QRCLAUTL the authorization list for the object. You can use 
the Display Authorization List Objects (DSPAUTLOBJ) command to determine 
which objects are secured by the QRCLAUTL authorization list. 


* Ifa lost object was in the Root file system, the object is placed in the /QReclaim 
directory. 


* Ifa lost object was in the QOpenSys file system, the object is placed in the 
/QOpenSys/QReclaim directory. 


* If an object in a directory is damaged to the extent that it is unusable, the system 
deletes it. The RCLSTG command does not attempt to rebuild damaged objects. 


* Ifa lost object was in a user-defined file system (UDFS), it is placed in the 
QReclaim directory located in the root directory of the UDFS. 


* Ifa lost object that was in a directory cannot be placed in the proper QReclaim 
directory based on its original location, then it is placed into the root directory of 
a special file system within the Auxiliary Storage Pool (ASP) in which the object 
resides. This special file system is created by RCLSTG when needed. The file 
system is named ’/dev/QASPxx/QReclaimFS.udfs’ where ’xx’ is the number for 
system and basic ASPs. The file system is named ’/dev/iasp- 
name /QReclaimFS.udfs’ where iasp-name is the name of the independent ASP. 


* For objects in the Root, QOpenSys, or user-defined file systems, the system takes 
actions for duplicate names or for unidentified object owners similar to the 
actions taken for objects in the QSYS.LIB file system. 


What To Do After Running the RCLSTG Procedure:|Table 6| describes both where to 


look for problems that the RCLSTG procedure detects and how to correct the 
problems: 
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Table 6. Resolving Problems Detected by the RCLSTG Procedure 


Where to Look for Problems 


How to Fix the Problem 


Type DSPMSG QSYSOPR to display the QSYSOPR message 
queue. Look for messages about damaged objects. 


Type DSPLOG QHST to display the history log. Look for 
messages about either damaged objects or rebuilt files. 


1. Delete unusable objects by using the appropriate 
DLTxxx command. Restore them by using the Restore 
Object (RSTOBJ) command. 


2. Copy data from rebuilt files to new files by using the 
Copy File (CPYF) command. 


Note: You may see a message indicating that objects 
were deleted by the reclaim storage procedure. These are 
internal system objects that are no longer needed. 


Type DSPLIB QRCL to display the QRCL library. 

Note: If the reclaim storage procedure did not place any 
objects in the ORCL library, you may receive a message 
that the library is not found. Ignore the message and 
continue with the next step. 


Move objects from the QRCL library to the correct library 
by using the Move Object (MOVOBJ) command. 


Notes: 
1. If IBM-supplied objects are in the QRCL library, 
contact software support for assistance. 


2. If you are unsure what to do with objects in the 
ORCL library, use the SAVLIB command to save the 
library to save media. Mark the media volume in case 
you need the objects later. 


Display the /QReclaim directory by using the Display 
Link (DSPLNK) command. 

Note: If the reclaim storage procedure did not place any 
objects in the /QReclaim directory, you may receive a 
message that the object is not found. Ignore the message 
and continue with the next step. 


Move objects from the /QReclaim directory to the correct 
directory by using the Move (MOV) command. 


Display the /QOpenSys/QReclaim directory by using 
the Display Link (DSPLNK) command. 

Note: If the reclaim storage procedure did not place any 
objects in the /QOpenSys/QReclaim directory, you may 
receive a message that the object is not found. Ignore the 
message and continue with the next step. 


Move objects from the /QOpenSys/QReclaim directory 
to the correct directory by using the Move (MOV) 
command. 


Type DSPMSG QSYSOPR to display the QSYSOPR message 
queue. Look for CPFAOD7 messages. For each CPFAOD7 
message that contains a directory name beginning with 
*/dev /QASPxx/’ (where ’xx’ is the number of a system 
or basic ASP) or ’/dev/iasp-name’ (where iasp-name is the 
name of an independent ASP), perform the action 
specified in the "How to Fix the Problem” column. 


Use the Add Mounted File System (ADDMFS) command 
to mount the user-defined file system (UDFS) specified 
in the CPFAOD7 message over a directory of your choice. 
Then use the Display Link (DSPLNK) command to view 
the contents of this UDFS. You may see objects with 
names beginning with ‘QRCL’ or you may see a 
directory named ’QReclaim’. If you see the ‘QReclaim’ 
directory, look inside it to find the object names 
beginning with ’QRCL’. These objects were previously 
lost but have been relocated by the RCLSTG command. 
Use the Move (MOV) command to move these objects 
back to their original location. The original object names 
may be specified in the CPFAOD7 message. If the original 
names are not available, use the "Display Attributes” 
option in DSPLNK to view an object’s attributes in order 
to attempt to identify it. 


Type WRKOBJOWN QDFTOWN to display objects that are 
owned by the QDFTOWN user profile. 


Use option 9 (Change owner) from the Work with 
Objects by owner display to transfer ownership to the 
correct user profile. 
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Table 6. Resolving Problems Detected by the RCLSTG Procedure (continued) 


Where to Look for Problems 


How to Fix the Problem 


Type DSPAUTLOBJ QRCLAUTL to display objects that are 
secured by the QRCLAUTL authorization list. 

Note: If the reclaim storage procedure did not assign 
any objects to the QRCLAUTL authorization list, you 
may receive a message that the authorization list is not 
found. Ignore the message. 


If necessary, assign the object to the correct authorization 
list by using the Edit Object Authority (EDTOBJAUT) 
command. 


Controlling Restoration of Security-Sensitive Objects 


You can use two different system values to control the restoration of 


security-sensitive objects: 


* Allow object restore operation (QALWOBJRST). 
* Verify object on restore (QVFYOBJRST). 
The QALWOBJRST system value determines whether objects that are 


security-sensitive may be restored to your system.The QVFYOBJRST system value 
is new for V5R1. It allows you to determine how the system restores objects with 


digital signatures. 


You can find information about system values and managing them through iSeries 
Navigator in the Information Center at 
http:/ /www.ibm.com/eserver/iseries/infocenter. See Systems management —> 


System values. 


QALWOBJRST system value 


You can use QALWOBJRST to prevent anyone from restoring a system-state object 
or an object that adopts authority. The QALWOBJRST system value affects 
programs, service programs, modules, and SQL packages. 


When your system is shipped, the QALWOBJRST system value is *ALL. This value 
is necessary to install your system successfully. 


r— Attention! 


* Recovering your system. 


These activities may fail if the QALWOBJRST value is not *ALL. 


It is important to set the QALWOBJRST value to *ALL before performing 
some system activities, such as: 


* Installing a new release of the OS/400 licensed program. 
* Installing new licensed programs. 


If you are applying PTFs, set the QALWOBJRST value to *ALWPTF. 


To ensure system security, return the QALWOBJRST value to your normal setting 
after completing the system activity. Make sure the entire restore operation has 
completed before changing the QALWOBJRST system value, or some objects may 


not restore successfully. 


You may specify multiple values for the QALWOBJRST system value, unless you 


specify *ALL or *NONE. 
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Possible Values for the QALWOBJRST System Value: 


*ALL Any object may be restored to your system by a user with 
the proper authority. 

*NONE Security-sensitive objects, such as system state programs or 
programs that adopt authority, may not be restored to the 
system. 

*ALWSYSST System state objects may be restored to the system. 

*ALWPGMADP Objects that adopt authority may be restored to the 
system. 

*ALWPTF Security-sensitive objects may be restored only when the 
restore is part of a Program Temporary Fix (PTF) 
operation. 

*ALWSETGID Allows the system to restore files with the S_ISGID 


attribute enabled 


*ALWSETUID Allows the system to restore files with the S_ISUID 


attribute enabled 


*ALWVLDERR Allows the system to restore objects with validation (CRC) 


errors. 


How to Set the QALWOBJRST System Value to Allow Complete Recovery 


1. 
2. 


6. 


Type WRKSYSVAL QALWOBJRST and press the Enter key. 


You are shown the Work with System Values display. Type 5 (Display) in the 
Opt column next to QALWOBJRST and press the Enter key. 


You are shown the Display System Value display. Write down the current 
setting for use after you complete your recovery. If the value is *ALL, you do 
not need to change it for your recovery. Skip to step 


Press F12 to return to the Work with System Values display. Type 2 (Change) in 
the Opt column next to QALWOBJRST and press the Enter key. 


You are shown the Change System Value display. Type *ALL for the value and 
press the Enter key. 


Press F12 to cancel the Work with System Values display. 


How to Set the QALWOBJRST System Value to Restrict Restore Operations 


ie 
2. 


4. 


Type WRKSYSVAL QALWOBURST and press the Enter key. 


You are shown the Work with System Values display. Type 2 (Change) in the 
Opt column next to QALWOBJRST and press the Enter key. 


You are shown the Change System Value display. Type the value you wrote 
down in step [3] of How to set the QALWOBJRST System Value to Allow 
Complete Recovery. Press the Enter key. 


Press F12 to cancel the Work with System Values display. 


QVFYOBJRST system value 


You can add digital signatures to objects so that users can verify the object’s 
integrity and origin. The objects affected by the QVFYOBJRST system value are as 
follows: 


*CMD 
*PGM 
*SRVPGM 
*SOLPKG 
*MODULE 
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* *STMF objects with attached Java’’ programs 


You need to install Digital Certificate Manager (OS/400 option 34) before you can 
use the QVFYOBJRST system value to verify objects not signed by IBM. If Digital 
Certificate Manager is not installed, the system treats user-state objects being 
restored as unsigned objects even if they contain digital signatures. You do not 
need to restart your system for changes to this value to take effect. You can find 
more information about digital signatures in the Information Center at the 
following Web site: 


http://www. ibm.com/eserver/iseries/infocenter 


The QVFYOBJRST system value allows you to control signature verification of 
objects during a restore operation. The QVFYOBJRST system value has five options 
(option 3 is the default): 


1. Do not verify signatures on restore. 
This is the only option that restores system-state or inherit-state objects without 
valid IBM-generated signatures. 


This option should not be used unless you have a large number of signed 
objects to restore which will fail their signature verification for some acceptable 
reason. Allowing a system-state or inherit-state object without a valid signature 
to restore represents an integrity risk to your system. If you choose to restore 
such an object onto your system by selecting this option, be sure to change it 
back to its previous value after the object has been restored. 


2. Verify: Restore unsigned objects; Restore signed object, even if signatures are 
not valid. 
Restores unsigned user-state objects. Restores signed user-state objects, even if 
signatures are not valid. Does not restore system-state or inherit-state objects 
without valid IBM-generated signatures. This option should be used only if 
there are specific objects with signatures that are not valid which you want to 
restore. In general, it is dangerous to restore objects with signatures that are not 
valid on your system. 


3. Verify: Restore unsigned objects; Restore signed objects only if signatures are 
valid. 
Restores unsigned user-state objects. Restores signed user-state objects only if 
signatures are valid. Does not restore system-state or inherit-state objects 
without valid IBM-generated signatures. 


4. Verify: Do not restore unsigned objects; Restore signed objects, even if 
signatures are not valid. 
Does not restore unsigned user-state objects. Restores signed user-state objects, 
even if signatures are not valid. Does not restore system-state or inherit-state 
objects without valid IBM-generated signatures. 


5. Verify: Do not restore unsigned objects; Restore signed objects only if 
signatures are valid. 
Does not restore unsigned user-state objects. Restores signed user-state objects 
only if signatures are valid. Does not restore system-state or inherit-state objects 
without valid IBM-generated signatures. This option is the most restrictive 
option and should be used when the only objects you want to allow to be 
restored are those which have been signed by trusted sources. 
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r— Attention! 


It is important to set the QVFYOBJRST value to 1 before performing some 
system activities, such as: 


* Installing a new release of the OS/400 licensed program. 
* Recovering your system. 


These activities may fail if the QVFYOBJRST value is not 1. 


How to Set the QVFYOBJRST System Value to Allow Complete Recovery 


1. 
2. 


6. 


Type WRKSYSVAL QVFYOBURST and press the Enter key. 


You are shown the Work with System Values display. Type 5 (Display) in the 
Opt column next to QVFYOBJRST and press the Enter key. 

You are shown the Display System Value display. Write down the current 
setting for use after you complete your recovery. If the value is 1, you do not 
need to change it for your recovery. Skip to step [6] 


Press F12 to return to the Work with System Values display. Type 2 (Change) 
the Opt column next to QVFYOBJRST and press the Enter key. 


You are shown the Change System Value display. Type 1 for the value and 
press the Enter key. 


Press F12 to cancel the Work with System Values display. 


How to Set the QVFYOBJRST System Value to Restrict Restore Operations 


i 
2. 


4. 


Type WRKSYSVAL QVFYOBJRST and press the Enter key. 


You are shown the Work with System Values display. Type 2 (Change) in the 
Opt column next to QVFYOBJRST and press the Enter key. 


You are shown the Change System Value display. Type the value you wrote 
down in step [3] of How to Set the QVFYOBJRST System Value to Allow 
Complete Recovery. Press the Enter key. 


Press F12 to cancel the Work with System Values display. 


in 


How to Set the QPFRADJ System Value for a Different Processor or 


Memory 


4. 


Type WRKSYSVAL QPFRADJ and press the Enter key. 


You are shown the Work with System Values display. Type 2 (Change) in the 
option column next to QPFRADJ and press the Enter key. 


You are shown the Change System Value display. Change the value to 2 
(Adjustment at IPL and automatic adjustment) and press the Enter key. 


Press F12 to cancel the Work with System Values display. 


Locked Objects While Restoring 


In general, an object is locked to prevent a read operation while it is being 
restored. If the system cannot obtain a lock on an object within the specified time, 
that object is not restored and a message is sent to the job log. 
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Table 7}shows the type of lock that is required to restore objects: 
Table 7. Lock Type Needed for Restore Operation 


Object Type Lock Type Needed for Restore Operation 
Most object types *EXCL 

*M36 object types *SHRRD 

Job queue *SHRRD 

Output queue *SHRRD 

Message queue *EXCLRD 

Library, during RSTLIB command *SHRUPD 


Library, when object is being restored to it *SHRUPD 


If you restore an Original Program Model (OPM) program that is running, the 
program may end abnormally. 


How to Verify That Objects Are Restored Successfully 


You can use the joblog or an output file to determine which objects are restored 
successfully. 


Note: The system does not restore files to libraries QGPL and QUSRSYS if the file 
names begin with QAPZ.No diagnostic message is sent indicating that these 
files are not restored. 


Using the Job Log: The restore commands send these messages: 


CPC3703 
Sent for each library that is restored. 


CPF3773 
Tells the number of objects that are restored and are not restored. 


CPF3839 
Completion message for RST command from media. 


CPF383E 
Completion message for RST command from a save file. 


CPF9003 
Completion message for RSTDLO command from media. 


CPF909B 
Completion message for RSTDLO command from a save file. 


These messages tell the number of objects that are restored and the number of 
objects that are not restored. An object is counted only if it fits the selection values 
you specified. For example, assume that library LIB1 has 75 objects. The names of 
74 of those objects begin with the characters ORD. You specify RSTOBJ OBJ (ORD*) 
OBJTYPE(*ALL) SAVLIB(LIB1). If all objects restored successfully, the completion 
message would say that 74 objects were restored to library LIB1. You would not be 
notified that 1 object was not restored. 


A diagnostic message is sent if: 


An object could not be restored. 
When the system cannot restore an object successfully, it is usually 
because: 
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* The object exists on the system and is being used. Restoring an object 
requires an exclusive lock for most object types. 


* The object is being saved or restored by another job. 
* The object on the media is damaged. 
* The user does not have the necessary authority to restore the object. 
* The object does not have a valid signature. 
* The object type is not supported in an independent ASP. 
* The user profile does not exist on the system. 
* The system found a validation error. 
Security information was changed. 
Under some conditions, the system may: 
* Revoke public and private authority 
* Change object ownership. 
* Change the object’s primary group. 
¢ Not link to the authorization list. 


See |“Sequence for Restoring Security Information” on page 221|for more 


information. 


An integrity change occurred. 


* Journaling could not be started for an object that was being journaled at 
the time of the save operation. 


* A logical file is restored over a deleted and re-created physical file. 


* The QAUDJRN (audit) journal was created by the system. You receive 
message CPF7088. If you restore the operating system and the 
QAUDLVL system value is not *NONE, the system creates the 
QAUDJRN if it does not exist. This ensures that security auditing is 
restarted for your system. 


Using An Output File: Most restore commands create output that shows what was 
restored. You can direct this output to a printer (OUTPUT(*PRINT)), a database file 
(OUTPUT(*OUTFILE)), a stream file, or a user space. The default for restore 
commands is not to create output. You must request it each time you run the 
restore command. Or you can change the default for the OUTPUT parameter for 
restore commands by using the Change Command Default (CHGCMDDFT) 
command. 


You can print the output and save it. Or you can create a program to analyze and 
report on the information in the output file. 


You can use the OUTPUT parameter with these commands: 


RST RSTDLO RSTOBJ 
RSTCFG RSTLIB RSTUSRPRF 


The online information for the restore commands tells the names of the model 
database outfiles they use for output. 


Notes: 


1. The output file you specify is in use throughout the restore operation. 
Therefore, the system cannot restore it as part of the operation. Depending on 
how you perform your restore operation, you may see a CPF379D message in 


Chapter 3. Restore Procedures-General Information 57 


the joblog for the output file. If you want to restore the output file after your 
restore operation completes, use the RSTOBJ command. 

2. The RST command places output in a stream file or a user space, rather than an 
output file. 

3. See the iSeries Information Center for more information about output from the 
save and restore commands. The RSTLIB, RSTOBJ, and RST commands have an 
information type (INFTYPE) parameter to specify how much detail you want in 
the output file. 


Recovery from an Unsuccessful Restore Operation 


A restore operation can be unsuccessful either because an error was encountered 
when trying to restore an object or because the operation was interrupted. If the 
object existed on the system before the restore operation, it may be damaged by 
the unsuccessful restore operation. 


An object is not restored when an error is encountered. The error is either 
recoverable or not. 


Restore Operation Error Is Recoverable: If an object cannot be restored and the 
error is recoverable, the following occurs: 


* A diagnostic message is sent to the job log for each object that is not restored. 
The message ID can vary, depending on why the object was not restored. 


* Each object that is associated with the errors is not restored. However, other 
objects not associated with the errors but involved in the same restore operation 
are restored. 


* Only the save and restore status information for the objects that were 
successfully restored is updated. 


* Account of the number of objects successfully restored and a count of the 
number of objects not restored are sent to the user in a diagnostic message. 


Restore Operation Error Is Not Recoverable: If the error is not recoverable, the 
following occurs: 


* Diagnostic messages are sent to the job log for each object. 

* The save and restore status information for each object is not updated. 

* A diagnostic message that identifies the error condition is sent to the user. 
* The restore command ends immediately. No other objects are restored. 


Recovering from an Error While Restoring Libraries 
Some errors that occur during a restore operation stop the operation. Following are 
a few examples of this type of error: 
* An unrecoverable media error. 
* Exceeding the maximum storage specified in the user profile of the user by 
running the restore operation or in a user profile that owns objects that are being 
restored. 


If an error stops the restore operation, you can correct the error condition and then 


start the restore operation where it ended. For example, if the maximum storage is 
exceeded, you can increase the MAXSTG parameter in the user profile. 
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You can use the STRLIB parameter on the RSTLIB command to restart the restore 
operation. The STRLIB parameter is valid only when *NONSYS, *ALLUSR, or 
*IBM is specified for the restore operation, 


The basic recovery steps for a restore operation are: 


1. 


4. 
5. 


Check the job log to determine the library where the previous RSTLIB 
SAVLIB(*NONSYS, *IBM, or *ALLUSR) failed. Find the last library that is 
restored which is indicated by a successful restore completion message. 


Load the media volume of the SAVLIB LIB(*NONSYS, *ALLUSR, or *IBM) 
media. 


Type the following and press the Enter key: 


RSTLIB SAVLIB(*NONSYS, *IBM or *ALLUSR) 

DEV (media-device-name) ENDOPT(*LEAVE) 
STRLIB(library-name) 
OMITLIB(library-name) 

* If the restore operation stopped because of a media error that you cannot 
correct, the library-name for the STRLIB and the OMITLIB parameters should 
be the library where the restore operation failed. This causes the operation to 
start with the library after that library. 


* If the failure was not related to a media error, the library-name for the STRLIB 
and the OMITLIB parameters should be the name of the last library that was 
successfully restored. This causes the operation to start with the library that 
caused the error. 


You will be asked to load the volume that contains the starting library. 


After the restore operation is complete, restore the library that failed using the 
media from a previous save operation. 


Note: Consider eliminating the media volume with the media error from the 
next save. 


Recovering from an Error While Restoring DLOs 


Some errors that occur during a restore operation stop the operation. Following are 
a few examples of this type of error: 


e An unrecoverable media error. 


* Exceeding the maximum storage specified in the user profile of the user by 


running the restore operation or in a user profile that owns objects that are being 


restored. 


If an error occurs that stops the restore operation, you can correct the error 


condition and then start the restore operation where it ended. For example, if the 


maximum storage is exceeded, you can increase the MAXSTG parameter in the 
user profile. 


If an unrecoverable error occurs when running the RSTDLO DLO(*ALL) 
SAVFLR(*ANY) command, you must determine where the failure occurred and 
continue the restore operation step-by-step. Do the following: 


1. Check the job log to determine if the failure occurred on a distribution object or 


a folder. The job log may identify where the failure occurred. 


2. If the failure occurred on a distribution object, the restore operation failed when 
the system was restoring mail. Go to|Recovering OfficeVision® Mail” on 
page 60 

3. Ifthe failure occurred on a folder, go to |“Recovering Documents and Folders” 
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Recovering OfficeVision® Mail 

To recover OfficeVision mail, do one of the following: 

* If you have daily save (GAVDLO DLO(*CHG or *MAIL)) media to restore later, 
the system restores your OfficeVision mail during the restore process from this 
save media. 

* Restore the OfficeVision mail from the next most current SAVDLO DLO(*ALL, 
“CHG, or *MAIL) FLR(*ANY) media volumes. Type the following to restore the 
mail: 

RSTDLO DLO(*MAIL) DEV(media-device-name) 

* If you do not have any media volumes from SAVDLO DLO(*ALL, *CHG, or 
*MAIL) FLR(*ANY), run the following program: 

CALL PGM(QSYS/QOHFIXIX) PARM(Y) 


Run this command so that the OfficeVision mail that was restored is usable. The 
system may not have restored some of your mail. 


If you need to restore the documents and folders from this set of save media, 


continue with|“Recovering Documents and Folders” 


Recovering Documents and Folders 
If an unrecoverable error occurs during the RSTDLO procedure, you can restart the 
procedure by using the SAVFLRparameter on the RSTDLO command. 


The basic recovery steps for a restore operation are: 


1. Check the job log to determine where the previous RSTDLO DLO(*ALL) 
command failed. The job log identifies which folder failed to restore. 


Note: If the failure occurred during the restore of mail, you need to restore all 
documents and folders. 

2. Find the first folder after the folder that failed to restore. Use the list that was 
created during the last SAVDLO OUTPUT(*PRINT or *OUTFILE) operation or 
use the DSPTAP DATA(*SAVRST) command to determine which first-level 
folder is next. To find the first-level folders, find the object type *FLR. Look at 
the Document or Folder Information column. The name of a first-level folder does 
not contain a forward slash (/). 


3. Load the first media volume of the SAVDLO DLO(*ALL) save media. 


Note: You must always start with the first volume of the SAVDLO media for 
each set of 300 first-level folders. You must load each volume in the set 
of SAVDLO save media in sequence. 


4. For each first-level folder, type the following and press the Enter key: 


RSTDLO DLO(*ALL) SAVFLR(folder-name-list) 
DEV (media-device-name) 


Where the folder-name-list has the names of the first-level folders identified from 
the list described in step |2| You can specify a limit of 300 first-level folders. 


Repeat this step for each set of 300 first-level folders. 
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How to Perform™ a Normal IPL 


You should perform a normal IPL at the end of any recovery before allowing users 
to resume normal activity. Do the following: 


1. Place the system in Normal mode. 
Using Logical Partitions?: 
If you are using logical partitions, perform these steps on the console of the 
logical partition on which you want to perform an IPL: 
a. Type STRSST on the command line and press Enter. 


b. On the System Service Tools display, select option 5 to work with system 
partitions, and press Enter. 


c. On the Work with System Partitions display, select option 2 to work with 
system partition status, and press Enter. 


d. On the Work with System Partition Status display, select normal mode by 
typing a 9 in the Option field. Press Enter. 


e. Press F3 until you see the Exit System Service Tools display. On the Exit 
System Service Tools display, press Enter. 


2. Ensure that no users are signed on and no jobs are active. 

3. If you are not using logical partitions, continue with the next step. Otherwise, if 
you are performing this operation from the primary partition, be sure to power 
down all secondary partitions. 

4. Type the following on a command line and press the Enter key: 

PWRDWNSYS OPTION(*IMMED) RESTART (*YES) 

5. When the IPL is complete, sign on the system. 

6. Start any other subsystems that need to be started, such as QTCP or QSNADS. 
STRSBS SBSD(subsystem-name) 


Parallel Restore Operations 


Beginning with V4R4MO0, you can perform restore operations while using more 
than one device simultaneously. The data that you restore in this manner must 
have been saved in parallel format. You can use the Restore Library (RSTLIB) or 
Restore Object (RSTOBJ) commands in conjunction with a media definition to 
perform a parallel restore. You can use a media definition with the RSTLIB 
command to restore *ALLUSR, *IBM, and *NONSYS libraries that were saved with 
a media definition. 


It may be possible to restore from a parallel save if you are using fewer devices 
than the save operation used. However, IBM does not recommend this, due to the 
amount of volume switching that you will need to do. IBM also does not 
recommend this due to performance reasons. If you are restoring files with 
constraints, you must use the same number of devices for the restore as you used 
for the save. Restore operations that use fewer drives should only be used 
occasionally to restore individual objects. Restore operations that use fewer drives 
should never be used as part of a system recovery strategy, or to restore large 
amounts of data. Whenever possible, the same number of devices that were used 
during the save operation should be used during a restore operation. 


A Display Tape (DSPTAP) command displays the list of objects that the system 


saves across all media files. You only need one media file to display all of the 
objects that the system saved during a parallel save operation. This list also 
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displays the number of media files that you need to restore data. However, you 
need all of the media files to restore any of the objects that the system saved. This 
may include multiple volumes. 


IBM recommends that you use the same media definition object when saving and 
restoring the same objects. If you use a different media definition object when 
restoring, make sure that the same number of media files are defined within that 
media definition object. If the number of media file definitions is different from the 
number that exists on the storage media, you will receive an error message. 


Recovery Considerations for Cryptographic Access Provider 


When you recover a system that includes Cryptographic Access Provider 
(5769AC3); the Cryptograhic Access Provider product fails when you use it. You 
must reinstall Cryptographic Access Provider after completing the recovery process 
in order to use it. 
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Chapter 4. Selecting the Right Recovery Strategy 


Use this chapter to determine the correct procedure for recovering your system. 
Before beginning your recovery, you must do the following: 


* Make sure you understand what has caused the problem. Understanding the 
cause helps you choose the correct recovery steps. 


* Plan your recovery. Use |Table 8 on page 67|to find the appropriate recovery 


checklist for your situation. 
* Make a copy of the checklist and check off each step as you complete it. 
* Keep the checklist for future reference. 


* Keep a record of what you have already done and what you do for the rest of 
your recovery. This record is important if you need help later. 


* If your problem requires hardware or software service, make sure you 
understand what the service representative did. Do not be afraid to ask 
questions, such as: 


— Was a disk unit replaced? If yes, which one? 


— Was the Licensed Internal Code restored? If yes, what option from the Install 
Licensed Internal Code (LIC) menu was used? 


— Did the disk configuration need to be recovered? Was it successful? 
— Could the failed disk unit be pumped? How successfully? 


Some Common Recovery Terminology 


You may need to understand these terms when discussing your situation with 
your service representative or software support: 


Term Definition 


Abnormal end (abend) A system failure or operator action that causes the system to 
end without being able to end all jobs and close all files. Your 
system may end abnormally because of a power failure or a 
problem with certain hardware or software components. 

Auxiliary storage pool A group of disk units defined from all the disk units that make 
up auxiliary storage. Auxiliary storage pools (ASPs), also 
known as disk pools in iSeries Navigator, allow you to isolate 
objects on one or more specific disk units. This may reduce the 
loss of data due to a disk media failure. In most cases, only 
data stored on disk units in the affected ASP is lost. 

ASP group An auxiliary storage pool (ASP) group is made up of a primary 
ASP and zero or more secondary ASPs. Each ASP is 
independent in regard to data storage, but in the ASP group 
they combine to act as one entity. If one ASP is made available 
or unavailable, the rest of the ASPs in the group are also made 
available or unavailable at the same time. In a clustered 
environment, all of the ASPs in a group switch to another node 
at the same time. The primary and secondary ASPs also share 
the same database. 

Basic ASP A user auxiliary storage pool created by grouping together a 
physical set of disk units and assigning them a number 
between 2 and 32. A basic ASP is always available for data 
storage and access. 
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Term 


Definition 


Dedicated service tools 
(DST) 
Disk configuration 


Disk pump 


Independent ASP 


Library user ASP 


Licensed Internal Code 


Load source unit 


Nonlibrary user ASP 


Primary ASP 


Secondary ASP 


System ASP 


System service tools (SST) 


User ASP 


64 0S/400 Backup and Recovery V5R2 


A set of tools to work with the system when the operating 
system is not available or not working. 

An internal system table that tells how the physical disk units 
are arranged on your system. The disk configuration is used to 
assign units to an auxiliary storage pool. The disk configuration 
is stored on the load source unit. 

A commonly used term for the procedure used by a service 
representative to attempt to copy data from a disk unit that has 
failed. 

A user auxiliary storage pool that can be made available 
(varied on) and made unavailable (varied off) without 
restarting the system. An independent ASP can be either 
switchable among multiple systems in a clustering environment 
or privately connected to a single system. 

A user ASP that contains libraries, directories, and folders and 
all the objects associated with them. 

The layer of iSeries architecture just above the hardware. You 
must have the Licensed Internal Code on your machine before 
you can restore the operating system. 

The first unit (unit 1) in the system ASP. It contains the 
Licensed Internal Code and the disk configuration for your 
system. 

A user ASP that may contain journals, journal receivers, and 
save files. The libraries associated with these objects are in the 
system ASP. A nonlibrary user ASP is sometimes called an 
old-style ASP, because it was the only type of user ASP 
available before Version 1 Release 3 of the OS/400 licensed 
program. 

An independent auxiliary storage pool (ASP) that defines a 
collection of directories and libraries and may have other 
secondary ASPs associated with it. A primary ASP defines a 
database for itself and other ASPs that may be added in its ASP 
group. Primary ASPs can only be implemented on V5R2 or 
later of OS/400. 

An independent ASP that defines a collection of directories and 
libraries and must be associated with a primary ASP in an ASP 
group. A possible use for a secondary ASP is to store journal 
receivers for objects being journaled in the primary ASP. 
Secondary ASPs can only be implemented on V5R2 or later of 
OS/400. 

An auxiliary storage pool that is created by the system and 
always configured. The system ASP (ASP 1) contains the 
Licensed Internal Code, licensed programs, and system 
libraries. The system ASP may also contain user libraries, 
folders, and directories. The system ASP contains all configured 
disk units that are not assigned to a user ASP. 

A subset of the DST tools. The tools available through SST, 
such as displaying the disk configuration, can be used while 
the operating system is running and other users are on the 
system. 

A basic or independent auxiliary storage pool created by 
grouping together a physical set of disk units. You can assign a 
basic ASP a number between 2 and 32. When you create an 
independent ASP, you specify a name; the system then assigns 
the independent ASP a number between 33 and 255. ASP 1 is 
always reserved as the system ASP. 


Term Definition 


UDFS ASP An independent auxiliary storage pool (ASP) that contains only 
user-defined file systems. It cannot be a member of an ASP 
group unless it is converted to a primary or secondary ASP. For 
conversion instructions, see iSeries Navigator online help for 
Disk Units, or the Independent Disk Pools topic in the iSeries 
Information Center at 
http: / /www.ibm.com/eserver /iseries /infocenter. 


Recovery Procedure for a Power Failure 
If your system stops because power is lost, you need to follow special procedures 
when you start the system again.|Chapter 7, “Starting the System After It Ends 
Abnormally” on page 169} describes this procedure. 


If you experience frequent power outages, consider using an uninterruptible power 
supply for your system. 


If power loss to workstations causes your system to perform constant error 


recovery, you should modify your applications to handle losing communications to 
workstations. |Chapter 25, “Techniques and Programming Examples for Backup and 
Recovery” on page 475|describes how to do this. 


Recovery Procedure for a System Failure 


A system failure is a problem either with hardware (other than DASD) or with 
operating system software that causes your system to end abnormally. After your 


service representative has corrected the problem, follow the procedure to start your 
system after an abnormal end. |Chapter 7, “Starting the System After It Ends 
Abnormally” on page 169 


describes the procedure. 


If the service representative replaced_a disk unit, use the information in 
the Recovery Procedure for a Disk Failure or Disk Errors” on page 66|to determine 


the correct recovery procedure. 


Recovery Procedure for a Program Failure or Human Error 


You may need to recover objects because a program updated them incorrectly or 
because a user deleted them. Review the information in|Chapter 10, “How to 
Restore Specific Types of Information” on page 221] for the kind of objects you are 


restoring. Some objects have special considerations or need to be restored in a 
particular sequence. 


If you are restoring an object that does not exist on the system, private authorities 
for the object are not restored with it. You can do one of the following: 


* Reconstruct the private authorities manually, using the Edit Object Authority 
(EDTOBJAUT) display. 
* Restore private authorities by using this procedure: 


1. Restore all user profiles from your most recent SAVSYS or SAVSECDTA tape. 
Type: RSTUSRPRF. Restoring user profiles requires a restricted state. 


2. Restore the objects you need to recover. 


3. Restore authorities. Type: RSTAUT. Only one RSTAUT command can run on 
the system at any given time. 
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Choosing the Recovery Procedure for a Disk Failure or Disk Errors 


; Attention 
When a system reference code (SRC) appears on your system unit, use the 
iSeries Licensed Internal Code Diagnostic Aids - Volume 1 to determine what the 
code means. If you receive an SRC code that indicates a DASD problem, do 
not perform an IPL before your service representative arrives. If you perform 
an IPL, your service representative may not be able to recover data from the 
damaged disk unit. 


This topic describes the actions that you take if you are recovering because a disk 
unit failed or was damaged. The steps you follow to recover from a disk failure 
depend on: 


¢ What unit failed. 


* Whether disk protection, such as device parity protection or mirrored protection 
is active. 


* Whether you have user ASPs configured. 


* Whether some or all of the sectors on the disk are damaged. If a disk unit must 
be replaced, a service representative normally tries to copy the information from 
the disk unit when it is replaced. This procedure is sometimes referred to as a 
disk pump. 


Use |Table 8 on page 67|to determine what recovery procedure you should follow, 


based on the failure that has occurred on your system. To find your situation on 
the chart, ask your service representative whether data was copied successfully 
(the results of the disk pump): 


Service Representative Terminology Terminology in Recovery Charts 
Full pump None of the data is lost 

Partial pump Some of the data is lost 

Could not pump All of the data is lost 


Recovery for Disk Errors That Do Not Require Disk Replacement: Some types of 
disk units automatically recover from errors without needing to be replaced. In 
some cases, however, sectors are damaged before the disk unit reassigns them and 
some object damage occurs. If you receive a message indicating that object damage 
has occurred and disk sectors have been reassigned, consider this to be the value 


Some for the column Data Loss on the Failed Unit in|Table 8 on page 67 


If you are recovering from disk errors but you did not need a service 
representative to replace the disk unit, you may need to perform tasks that are 
normally performed by a service representative. Make a copy of the appropriate 
checklist and mark it as follows: 

1. Begin at the task immediately following “Attach the new disk unit”. 


2. If the checklist contains a task called, “Restore the disk unit data”, skip that 
task. 
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Table 8. Choosing the Correct Recovery Procedure for Disk Media Failure 


Availability 
Type of Unit That Data Loss on Protection on Failed User ASPs 
Failed Failed Unit Unit Configured? Procedure to Follow 
Load source unit None None N/A? Checklist 1 on page 
Load source unit Some” None N/A! Checklist 2 on page 
Load source unit All None No Checklist 3 on page 
Load source unit. No All None Yes Checklist 4 on page 
basic ASPs in 
overflowed status® 
Load source unit. One All None Yes Checklist 5 on page 
or more basic ASPs in 
overflowed status?. 
Non-load source unit None None N/A* Checklist 6 on page 
in system ASP* 
Non-load source unit Some None N/A! Checklist 7 on page 
in system ASP* 
Non-load source unit All None No Checklist 8 on page 
in system ASP* 
Non-load source unit All None Yes Checklist 9 on page 
in system ASP*. No 
basic ASPs in 
overflowed status. 
Non-load source unit All None Yes Checklist 10 on page|84] 
in system ASP*. One 
or more basic ASPs in 
overflowed status?. 
Disk unit in basic ASP None None Yes Checklist 6 on page 
Disk unit in basic ASP Some? None Yes Checklist 11 on page 
Disk unit in basic All None Yes Checklist 12 on page|89| 
ASP. Failed unit not in 
overflowed status’. 
Disk unit in basic All None Yes Checklist 13 on page|91| 
ASP. Failed unit in 
overflowed status®. 
Disk unit in None None Yes Checklist 17 on page|95| 
independent ASP 
Disk unit in Some” None Yes Checklist 18 on page|96| 
independent ASP 
Disk unit in All None Yes Checklist 19 on page|97| 
independent ASP 
Any N/A Mirrored protection N/A? Checklist 14 on page/93| 
Any N/A Device parity N/A? Checklist 15 on page [94] 


protection 
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Table 8. Choosing the Correct Recovery Procedure for Disk Media Failure (continued) 


Availability 
Type of Unit That Data Loss on Protection on Failed User ASPs 
Failed Failed Unit Unit Configured? Procedure to Follow 


1 The recovery procedure is the same whether or not user ASPs are configured. 


2 If the service representative was partially successful in saving data from a failed disk unit, you should 
consider treating the situation as a complete data loss on the failed unit. 


If a unit in your system ASP fails and a replacement is not immediately available, you can use the procedure 
in Checklist 16 on page [94] This procedure allows you to return your system to operation. You will have less 
disk storage and you will need to recover all the data in the system ASP. 


@ Step|4 on page 196|/describes how to determine whether a user ASP is in overflowed status. 


Actions for load source disk unit failure—Checklist 1 


This checklist should be used for the following problem situation: 


Failed Unit: 
Load source unit 


Data Loss: 
None 


User ASP Configured: 
N/A 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Note: When your load source unit is failed and you are recovering from 
distribution media with Operations Console (LAN) configured, you may be 
required to use another console type for your recovery. See Connecting to 
iSeries --> What to connect with --> Operations Console in the iSeries 
Information Center at http://www.ibm.com/eserver /iseries /infocenter. 


Table 9. Recovery Checklist for Disk Failure-Checklist 1 
Task What To Do Where To Read More About It 


Actions to Be Performed by the Service Representative 


___ Task 1 Save the disk unit data. 
___ Task 2 Attach the new disk unit. 
___ Task 3 Install the Licensed Internal Code using “How to Prepare for Loading the 
option 4 (Install Licensed Internal Code and__|Licensed Internal Code” on page 124 
Restore Disk Unit Data). and |“How to Load the Licensed 
Internal Code” on page 132 
___ Task 4 Restore the disk unit data. 


Actions to Be Performed by the User 
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Table 9. Recovery Checklist for Disk Failure-Checklist 1 (continued) 


Task What To Do Where To Read More About It 
___ Task 5 You must perform an IPL at this time. Chapter 7, “Starting the System After It 


Follow the procedure for starting the system |Ends Abnormally”} task 1 through task 
after it ends abnormally. 4. 


Actions for load source disk unit failure—Checklist 2 


This checklist should be used for the following problem situation: 


Failed Unit: 
Load source unit 


Data Loss: 
Some 


User ASP Configured: 
N/A 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Note: When your load source unit is failed and you are recovering from 
distribution media with Operations Console (LAN) configured, you may be 
required to use another console type for your recovery. See Connecting to 
iSeries --> What to connect with --> Operations Console in the iSeries 
Information Center at http: //www.ibm.com/eserver /iseries /infocenter. 


Table 10. Recovery Checklist for Disk Failure-Checklist 2 


Task 


Actions to Be Performed by the Service Representative 


What To Do Where To Read More About It 


___ Task 1 Save the disk unit data. 
___ Task 2 Attach the new disk unit. 
___ Task 3 Install the Licensed Internal Code using “How to Prepare for Loading the 
option 4 (Install Licensed Internal Code and __ {Licensed Internal Code” on page 124| 
Restore Disk Unit Data). and|“How to Load the Licensed 
Internal Code” on page 132) 
___ Task 4 Restore the disk unit data. 


Actions to Be Performed by the User 


___ Task 5 You must perform an IPL at this time. Chapter 7, “Starting the System After It 
Follow the procedure for starting the system {Ends Abnormally”) task 1 through task 
after it ends abnormally. 4. 

___ Task 6 Restore the operating system. You are Chapter 6, “Restoring the Operating 
performing an abbreviated install operation. task 1 through task 6. 


Note: You may have some objects that are 
damaged. You may be required to perform a 
complete restore of the operating system. 
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Table 10. Recovery Checklist for Disk Failure-Checklist 2 (continued) 
Task What To Do Where To Read More About It 


___ Task 7 If you restored the operating system using “Recovering System Information” on 


distribution tapes, some system information, [page 221 
such as access path recovery times and the 

system reply list, may have been reset to 

default values. Verify these values and correct 

them if necessary. 


___ Task 8 Reclaim storage. “Reclaiming Storage” on page 48 


___ Task 9 Evaluate the extent of the damage. Determine 
whether you will attempt to recover damaged 
objects or restore the entire system. Do not 
skip this step. 


___ Task 10 If you have decided to do a complete restore 
operation, use to 
determine the correct procedure for restoring 
user information. 


“Task 4—Recovering from Damaged 


Objects and Unreadable Sectors” on 


___ Task 11 If you have decided to attempt to recover 
damaged objects, perform the tasks described 


in|“Task 4—Recovering from Damaged Objects 
and Unreadable Sectors” on page 177) 


Actions for load source disk unit failure—Checklist 3 


This checklist should be used for the following problem situation: 


Failed Unit: 
Load source unit 


Data Loss: 
All 


User ASP Configured: 
No 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Note: When your load source unit is failed and you are recovering from 
distribution media with Operations Console (LAN) configured, you may be 
required to use another console type for your recovery. See Connecting to 
iSeries --> What to connect with --> Operations Console in the iSeries 
Information Center at http://www.ibm.com/eserver /iseries /infocenter. 


Task What to Do Where To Read More About 
It 


Actions to Be Performed by the Service Representative 
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Task 


What to Do 


Where To Read More About 
It 


(assignment of disks to ASPs and 
protection). 


__ Task 1 Attach the new disk unit. 

__ Task 2 Prepare to load the Licensed “How to Prepare for Loading 
Internal Code. the Licensed Internal Code” on 

__ Task 3 Install the Licensed Internal Code _|“How to Load the Licensed 
using option 3 (Install Licensed Internal Code” on page 132) 
Internal Code and Recover 
Configuration). 

__ Task 4 Recover the disk configuration “How to Recover Your Disk 


Configuration” on page 143 


Actions to Be Performed by the User 


__ Task 5 


Restore the Operating System” on 


You are performing a 
complete restore operation. 


“Task 1-Starting to 


Chapter 16, "Restoring the 
Operating System”, task 1 
through task 6. 


___ Task 6 


If you restored the operating 
system using distribution media, 
some system information, such as 


access path recovery times and the 


system reply list, was returned to 
default values. Set these values 
correctly. 


“Recovering System 


Information” on page 221 


___ Task 7 


determine the correct procedure 
for recovering user information. 
You will need to recover all user 
data. 


Actions for load source disk unit failure—Checklist 4 


This checklist should be used for the following problem situation: 


Failed Unit: 


Load source unit 


Data Loss: 
All 


User ASP Configured: 


Yes 


Basic User ASP Overflowed: 


No 
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;_ Attention! 
When you replace a disk unit in your system ASP, the system loses 
addressability to the objects in your basic user ASPs. Recovering object 
ownership for objects other than DLOs will require manually assigning 
ownership for every object in every basic user ASP. You may want to treat 
this situation as a total recovery and restore all your information from your 
save media if the following conditions are true: 


1. You have a large number of objects in your basic user ASPs 
2. You have thoroughly backed up your system 


If you choose to do this, perform the steps that are described in 


your entire system after a complete system loss—Checklist 20” on page 98] to 


recover your system. 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Note: When your load source unit is failed and you are recovering from 
distribution media with Operations Console (LAN) configured, you may be 
required to use another console type for your recovery. See Connecting to 
iSeries --> What to connect with --> Operations Console in the iSeries 
Information Center at http://www.ibm.com/eserver /iseries /infocenter. 


Table 11. Recovery Checklist for Disk Failure—Checklist 4 


Task 


What To Do Where To Read More About It 


Actions to Be Performed by the Service Representative 


__ Task 1 Attach the new disk unit. 
___ Task 2 Prepare to load the Licensed Internal Code. _ |“How to Prepare for Loading the 
Licensed Internal Code” on page 124 
__ Task 3 Install the Licensed Internal Code using “How to Load the Licensed Internal 
option 3 (Install Licensed Internal Code and |Code” on page 132) 
Recover Configuration). 
___ Task 4 Recover the disk configuration (assignment _|“How to Recover Your Disk 


Actions to Be Performed by the User 


of disks to ASPs and protection). Configuration” on page 143) 


___ Task 5 


Restore the operating system, beginning with {Chapter 6, “Restoring the Operating 
System” on page 147] task 1 through 


“Task 1-Starting to Restore the Operating 
System” on page 150} You are performing a __ task 6. 


complete restore operation. 
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Table 11. Recovery Checklist for Disk Failure—Checklist 4 (continued) 


Task What To Do Where To Read More About It 

___ Task 6 If you restored the operating system using “Recovering System Information” on| 
distribution media, some system information, |page 221 
such as access path recovery times and the 
system reply list, was returned to default 
values. Set these values correctly. 

___ Task 7 If necessary, change the QALWOBJRST “Controlling Restoration of 
system value by using the WRKSYSVAL Security-Sensitive Objects” on page 52 
command. Write the old value here: 

___ Task 8 If necessary, change the QVFYOBJRST “Controlling Restoration of 
system value by using the WRKSYSVAL Security-Sensitive Objects” on page 52 
command. Write the old value here: 

___ Task 9 If necessary, change the system value that The System Values subtopic of the 
controls whether the job log wraps when it is System Management topic in the 
full. Use the Work with System Values iSeries Information Center. 
command: WRKSYSVAL QJOBMSGOQFL. 

Write down the current value here: 
. Then change the value to 
*PRTWRAP. 

___ Task 10 After changing the system values, sign off by |Describing the Contents of Your User 
using the command SIGNOFF *LIST. Then, —|Auxiliary Storage Pools” on page 185 
using a newly created password, sign back 
on as QSECOFR for the new values to take 
effect. 

___ Task 11 Describe or diagram, as much as possible, “Describing the Contents of Your User 
the contents of your user ASPs before the Auxiliary Storage Pools” on page 185 
failure. 

___ Task 12 Recover user profiles, configuration, libraries |“How to Recover a Basic User ASP; 
in the system ASP, and the contents of your {After Recovering the System ASP” on 
basic user ASPs. If you choose not to restore task 1 through task 11. 
all of your libraries at this time, ensure that 
you restore the QGPL and QUSRSYS 
libraries along with the libraries that you are 
restoring. 

___ Task 13 Restore document library objects. “Restoring Documents and Folders” on| 

page 262 

___ Task 14 Restore your last complete save of “Restoring Objects in Directories” o 
directories." page 268 

___ Task 15 If you have User-Defined File Systems in “Task 7—-Restoring User-Defined File 
User ASPs that do not restore correctly, you [Systems to the User Auxiliary Storage 
may need to perform additional recovery Pool” on page 191 
steps. 

___ Task 16 Restore changed objects and apply journaled |Chapter 11, “How to Restore Changed 
changes. Objects and Apply Journaled Changes” 

task 1 through task 7. 

___ Task 17 If you use Cryptographic Access Provider, “Recovery Considerations for 
install the Cryptographic Access Provider Cryptographic Access Provider” on 
licensed program (5769AC3) using option 11 
on the Work with Licensed Programs menu. 

___ Task 18 Restore authority. Type: RSTAUT “Restoring Object Authorities” on| 
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Table 11. Recovery Checklist for Disk Failure—Checklist 4 (continued) 


Task What To Do Where To Read More About It 

___ Task 19 Reapply any PTFs that were applied since “How to Restore Program Temporary 
your last SAVSYS operation. Fixes” on page 280 

___ Task 20 If you use Windows server on iSeries and “Completing Recovery for the iSeries 
saved with the Integrated xSeries Server Integration for Windows Server 
(NWSD) varied off, complete recovery for Product” on page 270 
the Windows server on iSeries. 

__ Task 21 If you run Linux and saved Linux by “Recovering Linux in a Partition” on 
varying off the network server description page 271 
(NWSD) for Linux, complete the recovery for 
Linux. 

___ Task 22 If necessary, change the QALWOBJRST “Controlling Restoration of 
system value back to its original value by Security-Sensitive Objects” on page 52 
using the WRKSYSVAL command. 

___ Task 23 If necessary, change the QVFYOBJRST “Controlling Restoration of 
system value back to its original value by Security-Sensitive Objects” on page 52 
using the WRKSYSVAL command. 

___ Task 24 If necessary, change the QROBMSGQFL The System Values subtopic of the 
system value back to its original value by System Management topic in the 
using the WRKSYSVAL command. iSeries Information Center. 

___ Task 25 Perform either a: 

SIGNOFF *LIST 
ora 
DSPJOBLOG * *PRINT 
Check the job log to ensure all objects were 
restored. The job log contains information 
about the restore operation. To verify that all 
objects were restored, spool the job log for 
printing along with the job’s remaining 
spooled output, if any. 
Message CPC3703 is sent to the job log for 
each library that was successfully restored. 
Message CPF3773 is sent to tell you how 
many objects were restored. Objects are not 
restored for various reasons. Check for any 
error messages, correct the errors, and then 
restore those objects from the media. 
___ Task 26 You must perform an IPL at this time. “How to Perform’ a Normal IPL” on 
page 61 

___ Task 27 If you use Windows server on iSeries and “Completing Recovery for the iSeries 
saved with the Integrated xSeries Server Integration for Windows Server 
(NWSD) varied on, complete recovery for the |Product” on page 270 
Windows server on iSeries product. 

___ Task 28 If IBM Content Manager OnDemand for 


iSeries is installed, complete journaling for 
IBM Content Manager OnDemand for iSeries 
by typing the following commands: 

CALL QRDARS/QRLCSTRJ PARM('RLC') 


CALL QRDARS/QRLCSTRJ PARM('RLR') 
CALL QRDARS/QRLCSTRJ PARM('RLO') 
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Table 11. Recovery Checklist for Disk Failure—Checklist 4 (continued) 


Task What To Do Where To Read More About It 
___ Task 29 Review job logs or output from your restore |“How to Verify That Objects Are 


operations to ensure that all objects were Restored Successfully” on page 56 


restored successfully. 


You may receive one of the following messages: 


CPD377A: Object not restored, /QNTC. 
CPD377A: Object not restored, /QNetWare. 


These objects cannot be restored until their file systems have been mounted during the IPL. You may 
ignore these messages. The additional recovery tasks will guide you through the steps to restore these 


objects. 


Note: Since the OS/400 Enhanced Integration for Novell NetWare software resides on a remote server, you 
do not have to restore your Netware data when you restore your server. Previously, the OS/400 Integration 
for Novell NetWare product ran on a Integrated xSeries Server and you had to restore the Novell product 


if you completely restored your server. 


Actions for load source disk unit failure—Checklist 5 


This checklist should be used for the following problem situation: 


Failed Unit: 
Load source unit 


Data Loss: 
All 


User ASP Configured: 
Yes 


Basic User ASP Overflowed: 
Yes 


r— Attention! 


When you replace a disk unit in your system ASP, the system loses 
addressability to the objects in your basic user ASPs. Recovering object 
ownership for objects other than DLOs will require manually assigning 
ownership for every object in every basic user ASP. You may want to treat 
this situation as a total recovery and restore all your information from your 
save media if the following conditions are true: 


1. You have a large number of objects in your user ASPs 
2. You have thoroughly backed up your system 


If you choose to do this, perform the steps that are described in 
your entire system after a complete system loss—Checklist 20” on page 98 
recover your system. 


“Recovering 
to 


Note: When your load source unit is failed and you are recovering from 
distribution media with Operations Console (LAN) configured, you 
may be required to use another console type for your recovery. See 
Connecting to iSeries --> What to connect with --> Operations 
Console in the iSeries Information Center at 
http://www.ibm.com/eserver/iseries /infocenter. 
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Table 12. Recovery Checklist for Disk Failure-Checklist 5 


Task What To Do Where To Read More About It 
Actions to Be Performed by the Service Representative 
__ Task 1 Attach the new disk unit. 
___ Task 2 Prepare to load the Licensed Internal Code. |“How to Prepare for Loading the 
Licensed Internal Code” on page 124 
___ Task 3 Install the Licensed Internal Code using “How to Load the Licensed Internal 
option 3 (Install Licensed Internal Code and |Code” on page 132) 
Recover Configuration). 
___ Task 4 Recover the disk configuration (assignment _|“How to Recover Your Disk 


of disk to ASPs and protection). 


Configuration” on page 143) 


Actions to Be Performed by the User 


___ Task 5 Restore the operating system, beginning with |Chapter 6, “Restoring the Operating 
task 1 through 
You are performing a __ task 6. 
complete restore operation. 

___ Task 6 If you restored the operating system using 
distribution media, some system information, 
such as access path recovery times and the 
system reply list, may have been reset to 
default values. Verify these values and 
correct them if necessary. 

___ Task 7 If necessary, change the QALWOBJRST 
system value. Write the old value here: Security-Sensitive Objects” on page 52 

___ Task 8 If necessary, change the QVFYOBJRST 
system value. Write the old value here: Security-Sensitive Objects” on page 52 

___ Task 9 If necessary, change the system value that The System Values subtopic of the 
controls whether the job log wraps when it is System Management topic in the 
full. Use the Work with System Values iSeries Information Center. 
command: WRKSYSVAL QJOBMSGOEFL. 

Write down the current value here: 
. Then change the value to 
*PRTWRAP. 

___ Task 10 After changing the system values, sign off by 
using the command SIGNOFF *LIST. Then, Auxiliary Storage Pools” on page 185 
using a newly created password, sign back 
on as QSECOFR for the new values to take 
effect. 

___ Task 11 Describe or diagram, as much as possible, 
the contents of your user ASPs before the Auxiliary Storage Pools” on page 185 
failure. 

___ Task 12 Recover user profiles, configuration, libraries 


in the system ASP, and the contents of the 
user ASPs that were not in overflowed 
status. If you choose not to restore all of 
your libraries at this time, ensure that you 
restore the QGPL and QUSRSYS libraries 
along with the libraries that you are 
restoring. 
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After Recovering the System ASP” on 


task 1 through task 11. 


Table 12. Recovery Checklist for Disk Failure-Checklist 5 (continued) 


Task What To Do Where To Read More About It 

___ Task 13 Recover the objects in the user ASPs that “How to Recover a Damaged Basic 
were overflowed. Auxiliary Storage Pool” on page 200 

task 1 through task 9. 

___ Task 14 Restore document library objects to the “Restoring Documents and Folders” on| 
system ASP and to any overflowed user page 262 
ASPs that had DLOs. 

___ Task 15 Restore your last complete save of “Restoring Objects in Directories” o 
directories." page 268 

___ Task 16 If you have User-Defined File Systems in “Task 7—Restoring User-Defined File 
User ASPs that do not restore correctly, you [Systems to the User Auxiliary Storage 
may need to perform additional recovery Pool” on page 191 
steps. 

___ Task 17 Restore changed objects and apply journaled |Chapter 11, “How to Restore Changed 
changes. Objects and Apply Journaled Changes” 

___ Task 18 If you use Cryptographic Access Provider, “Recovery Considerations for 
install the Cryptographic Access Provider Cryptographic Access Provider” on| 
licensed program (5769AC3) using option 11 
on the Work with Licensed Programs menu. 

___ Task 19 Restore authority. Type: RSTAUT “Restoring Object Authorities” on 

___ Task 20 Reapply any PTFs that were applied since “How to Restore Program Temporar 
your last SAVSYS operation. Fixes” on page 280 

___ Task 21 If you use Windows server on iSeries and “Completing Recovery for the iSeries 
saved with the Integrated xSeries Server Integration for Windows Server 
(NWSD) varied off, complete recovery for Product” on page 270 
the Windows server on iSeries. 

___ Task 22 If you run Linux and saved Linux by 
varying off the network server description page 271 
(NWSD) for Linux, complete the recovery for 
Linux. 

___ Task 23 If necessary, use the WRKSYSVAL command _ |“Controlling Restoration of| 
to change the QALWOBJRST system value Security-Sensitive Objects” on page 52 
back to its original value. 

___ Task 24 If necessary, use the WRKSYSVAL command _ |“Controlling Restoration of 
to change the QVFYOBJRST system value Security-Sensitive Objects” on page 52 
back to its original value. 

___ Task 25 If necessary, change the QIOBMSGQFL The System Values subtopic of the 


system value back to its original value by 
using the WRKSYSVAL command. 


System Management topic in the 
iSeries Information Center. 
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Table 12. Recovery Checklist for Disk Failure-Checklist 5 (continued) 


Task What To Do Where To Read More About It 


___ Task 26 Perform either a: 
SIGNOFF *LIST 


ora 
DSPJOBLOG * *PRINT 


Check the job log to ensure all objects were 
restored. The job log contains information 
about the restore operation. To verify that all 
objects were restored, spool the job log for 
printing along with the job’s remaining 
spooled output, if any. 


Message CPC3703 is sent to the job log for 
each library that was successfully restored. 
Message CPF3773 is sent to tell you how 
many objects were restored. Objects are not 
restored for various reasons. Check for any 
error messages, correct the errors, and then 
restore those objects from the media. 


___ Task 27 You must perform a normal IPL at this “How to Perform™ a Normal IPL” on] 
time. 


“Completing Recovery for the iSeries 
Integration for Windows Server 
Product” on page 270 


Task 28 If you use Windows server on iSeries and 
; > saved with the Integrated xSeries Server 
(NWSD) varied on, complete recovery for the 
Windows server on iSeries product. 


___ Task 29 If IBM Content Manager OnDemand for 
iSeries is installed, complete journaling for 
IBM Content Manager OnDemand for iSeries 
by typing the following commands: 
CALL QRDARS/QRLCSTRJ PARM('RLC') 
CALL QRDARS/QRLCSTRJ PARM('RLR') 
CALL QRDARS/QRLCSTRJ PARM('RLO') 


___ Task 30 Review job logs or output from your restore |“How to Verify That Objects Are 
operations to ensure that all objects were Restored Successfully” on page 56 


restored successfully. 


You may receive one of the following messages: 


CPD377A: Object not restored, /QNTC. 
CPD377A: Object not restored, /QNetWare. 


These objects cannot be restored until their file systems have been mounted during the IPL. The additional 
recovery tasks will guide you through the steps to restore these objects. 

Note: Since the OS/400 Enhanced Integration for Novell NetWare software resides on a remote server, you 
do not have to restore your Netware data when you restore your. Previously, the OS/400 Integration for 
Novell NetWare product ran on a Integrated xSeries Server and you had to restore the Novell product if 
you completely restored your. 


Actions for non-load source disk unit failure or disk units in 
basic user ASP disk failure—Checklist 6 
This checklist should be used for the following problem situation: 
Failed Unit: 
Non-load source unit in system ASP or Disk unit in basic user ASP 
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Data Loss: 
None 


User ASP Configured: 
N/A 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Table 13. Recovery Checklist for Disk Failure-Checklist 6 


Task What To Do Where To Read More About It 
Actions to Be Performed by the Service Representative 

___ Task 1 Save the disk unit data. 

___ Task 2 Attach a new disk unit. 

___ Task 3 Restore data to the new disk unit. 


Actions to Be Performed by the User 


___ Task 4 Perform an IPL. Follow the procedure for Chapter 7, “Starting the System After It 
starting the system after it ends abnormally. |Ends Abnormally”} task 1 through task 
4. 


Actions for non-load source disk unit failure—Checklist 7 
This checklist should be used for the following problem situation: 


Failed Unit: 
Non-load source unit in system ASP 


Data Loss: 
Some 


User ASP Configured: 
N/A 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Table 14. Recovery Checklist for Disk Failure-Checklist 7 
Task What To Do Where To Read More About It 


Actions to Be Performed by the Service Representative 
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Table 14. Recovery Checklist for Disk Failure-Checklist 7 (continued) 


Task What To Do Where To Read More About It 
___ Task 1 Save the disk unit data. 

___ Task 2 Attach the new disk unit. 

___ Task 3 Restore the disk unit data. 


Actions to Be Performed by the User 
___ Task 4 


Restore the operating system, beginning with |Chapter 6, “Restoring the Operating 
“Task 1-Starting to Restore the Operating System”} task 1 through task 6. 
System” on page 150} You are performing a 


complete restore operation. 


___ Task 5 If you restored the operating system using “Recovering System Information” on| 


distribution media, some system information, 
such as access path recovery times and the 

system reply list, may have been reset to 

default values. Verify these values and 

correct them if necessary. 


___ Task 6 Reclaim storage. “Reclaiming Storage” on page 48 


“Task 4-Recovering from Damaged 
Objects and Unreadable Sectors” on 


___ Task 7 Evaluate the extent of the damage. 
Determine whether you will attempt to 
recover damaged objects or restore the entire 
system. Do not skip this step. 


___ Task 8 If you have decided to do a complete restore 
operation, use to 
determine the correct procedure for 
recovering user information. 


___ Task 9 If you have decided to attempt to recover 
damaged objects, perform the tasks in 


Actions for non-load source disk unit failure—Checklist 8 


This checklist should be used for the following problem situation: 


Failed Unit: 
Non-load source unit in system ASP 


Data Loss: 
All 


User ASP Configured: 
No 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Table 15. Recovery Checklist for Disk Failure-Checklist 8 
Task What To Do Where To Read More About It 


Actions to Be Performed by the Service Representative 


___ Task 1 Attach the new disk unit. 


___ Task 2 Delete the ASP data. 
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Table 15. Recovery Checklist for Disk Failure-Checklist 8 (continued) 


Task What To Do Where To Read More About It 
___ Task 3 Restore the Licensed Internal Code using “How to Prepare for Loading the 


Licensed Internal Code” on page 124 


and|How to Load the Licensed 


Internal Code” on page 132 


option 1 (Restore Licensed Internal Code). If 
user ASPs are configured, they remain intact. 


Actions to Be Performed by the User 


___ Task 4 Restore the operating system, beginning with |Chapter 6, “Restoring the Operating 
“Task 1-Starting to Restore the Operating task 1 through task 6. 
System” on page 150} You are performing a 
complete restore operation. 
___ Task 5 If you restored the operating system using “Recovering System Information” on| 
distribution media, some system information, 
such as access path recovery times and the 
system reply list, may have been reset to 
default values. Verify these values and 
correct them if necessary. 
___ Task 6 Reclaim storage. “Reclaiming Storage” on page 48 
___ Task 7 Use |Table 30 on page 107] to determine the 


correct procedure for recovering user 
information. 


Actions for non-load source disk unit failure—Checklist 9 


This checklist should be used for the following problem situation: 


Failed Unit: 
Non-load source unit in system ASP 


Data Loss: 
All 


User ASP Configured: 
Yes 


User ASP Overflowed: 
No 


; Attention! 
When you replace a disk unit in your system ASP, the system loses 
addressability to the objects in your user ASPs. Recovering object ownership 
for objects other than DLOs will require manually assigning ownership for 
every object in every user ASP. You may want to treat this situation as a total 
recovery and restore all your information from your save media if the 
following conditions are true: 


1. You have a large number of objects in your user ASPs 
2. You have thoroughly backed up your system 


If you choose to do this, perform the steps that are described in 
your entire system after a complete system loss—Checklist 20” on page 98 
recover your system. 


“Recovering 
to 
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Table 16. Recovery Checklist for Disk Failure-Checklist 9 


Task What To Do Where To Read More About It 


Actions to Be Performed by the Service Representative 


__ Task 1 Delete the data in the ASP that contains the 
failed unit. 

___ Task 2 Replace the failed disk unit. 

___ Task 3 Configure the replacement disk unit by 


adding it to the correct ASP. 


“How to Prepare for Loading the 


Licensed Internal Code” on page 124 


“How to Load the Licensed 


Internal Code” on page 132 


__ Task 4 Restore the Licensed Internal Code using 
option 1 (Restore Licensed Internal Code). If 
user ASPs are configured, they remain intact. 


Actions to Be Performed by the User 


__ Task 5 Restore the operating system, beginning with |Chapter 6, “Restoring the Operating 
“Task 1-Starting to Restore the Operating task 1 through task 6. 
System” on page 150} You are performing a 


complete restore operation. 


___ Task 6 If you restored the operating system using “Recovering System Information” on| 


distribution media, some system information, 
such as access path recovery times and the 

system reply list, may have been reset to 

default values. Verify these values and 

correct them if necessary. 


___ Task 7 If necessary, change the QALWOBJRST 
system value. Write the old value here: 


“Controlling Restoration of 


Security-Sensitive Objects” on page 52 


“Controlling Restoration of 


Security-Sensitive Objects” on page 52 


___ Task 8 If necessary, change the QVFYOBJRST 
system value. Write the old value here: 


___ Task 9 If necessary, change the system value that The System Values subtopic of the 
controls whether the job log wraps when it is System Management topic in the 
full. Use the Work with System Values iSeries Information Center. 


command: WRKSYSVAL QJOBMSGOFL. 
Write down the current value here: 

. Then change the value to 
*PRTWRAP. 


___ Task 10 After changing the system values, sign off by |“Describing the Contents of Your User 
using the command SIGNOFF *LIST. Then, Auxiliary Storage Pools” on page 185 


using a newly created password, sign back 
on as QSECOFR for the new values to take 
effect. 


___ Task 11 Describe or diagram, as much as possible, “Describing the Contents of Your User 
the contents of your user ASPs before the Auxiliary Storage Pools” on page 185 


failure. 
“How to Recover a Basic User ASP’ 
After Recovering the System ASP” on 


task 1 through task 11. 


___ Task 12 Recover user profiles, configuration, libraries 
in the system ASP, and the contents of your 
basic user ASPs. If you choose not to restore 
all of your libraries at this time, ensure that 
you restore the QGPL and QUSRSYS 
libraries along with the libraries that you are 
restoring. 


___ Task 13 Restore document library objects to the “Restoring Documents and Folders” on| 
system ASP. 
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Table 16. Recovery Checklist for Disk Failure-Checklist 9 (continued) 


Task What To Do Where To Read More About It 

___ Task 14 Restore your last complete save of “Restoring Objects in Directories” 0 
directories." page 268 

___ Task 15 If you have User-Defined File Systems in “Task 7—-Restoring User-Defined File 
User ASPs that do not restore correctly, you [Systems to the User Auxiliary Storage 
may need to perform additional recovery Pool” on page 191 
steps. 

___ Task 16 Restore changed objects and apply journaled |Chapter 11, “How to Restore Changed 
changes. Objects and Apply Journaled Changes” 

task 1 through task 7. 

___ Task 17 If you use Cryptographic Access Provider, “Recovery Considerations for 
install the Cryptographic Access Provider Cryptographic Access Provider” on 
licensed program (5769AC3) using option 11 
on the Work with Licensed Programs menu. 

___ Task 18 Restore authority. Type: RSTAUT “Restoring Object Authorities” on 

___ Task 19 Reapply any PTFs that were applied since “How to Restore Program Temporar 
your last SAVSYS operation. Fixes” on page 280 

___ Task 20 If you use Windows server on iSeries and “Completing Recovery for the iSeries 
saved with the Integrated xSeries Server Integration for Windows Server 
(NWSD) varied off, complete recovery for Product” on page 270 
the Windows server on iSeries product. 

___ Task 21 If you run Linux and saved Linux by 
varying off the network server description 
(NWSD) for Linux, complete the recovery for 
Linux. 

___ Task 22 If necessary, change the QALWOBJRST “Controlling Restoration of 
system value back to its original value by Security-Sensitive Objects” on page 52 
using the WRKSYSVAL command. 

___ Task 23 If necessary, change the QVFYOBJRST “Controlling Restoration of 
system value back to its original value by Security-Sensitive Objects” on page 52 
using the WRKSYSVAL command. 

___ Task 24 If necessary, change the QROBMSGQFL The System Values subtopic of the 


system value back to its original value by 
using the WRKSYSVAL command. 


System Management topic in the 
iSeries Information Center. 


Chapter 4. Selecting the Right Recovery Strategy 83 


Table 16. Recovery Checklist for Disk Failure-Checklist 9 (continued) 


Task What To Do Where To Read More About It 


___ Task 25 Perform either a: 
SIGNOFF *LIST 


ora 
DSPJOBLOG * *PRINT 


Check the job log to ensure all objects were 
restored. The job log contains information 
about the restore operation. To verify that all 
objects were restored, spool the job log for 
printing along with the job’s remaining 
spooled output, if any. 


Message CPC3703 is sent to the job log for 
each library that was successfully restored. 
Message CPF3773 is sent to tell you how 
many objects were restored. Objects are not 
restored for various reasons. Check for any 
error messages, correct the errors, and then 
restore those objects from the media. 


___ Task 26 You must perform a normal IPL at this “How to Perform™ a Normal IPL” on] 
time. 


“Completing Recovery for the iSeries 
Integration for Windows Server 
Product” on page 270 


Task 27 If you use Windows server on iSeries and 
; > saved with the Integrated xSeries Server 
(NWSD) varied on, complete recovery for the 
Windows server on iSeries product. 


___ Task 28 If IBM Content Manager OnDemand for 
iSeries is installed, complete journaling for 
IBM Content Manager OnDemand for iSeries 
by typing the following commands: 
CALL QRDARS/QRLCSTRJ PARM('RLC') 
CALL QRDARS/QRLCSTRJ PARM('RLR') 
CALL QRDARS/QRLCSTRJ PARM('RLO') 


___ Task 29 Review job logs or output from your restore |“How to Verify That Objects Are 
operations to ensure that all objects were Restored Successfully” on page 56 


restored successfully. 


You may receive one of the following messages: 


CPD377A: Object not restored, /QNTC. 
CPD377A: Object not restored, /QNetWare. 


These objects cannot be restored until their file systems have been mounted during the IPL. You may 
ignore these messages. The additional recovery tasks will guide you through the steps to restore these 
objects. 

Note: Since the OS/400 Enhanced Integration for Novell NetWare software resides on a remote server, you 
do not have to restore your Netware data when you restore your. Previously, the OS/400 Integration for 
Novell NetWare product ran on a Integrated xSeries Server and you had to restore the Novell product if 
you completely restored your. 


Actions for non-load source disk unit failure—Checklist 10 


This checklist should be used for the following problem situation: 


Failed Unit: 
Non-load source unit in system ASP 
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;_ Attention! 
When you replace a disk unit in your system ASP, the system loses 
addressability to the objects in your user ASPs. Recovering object ownership 
for objects other than DLOs will require manually assigning ownership for 
every object in every user ASP. You may want to treat this situation as a total 
recovery and restore all your information from your save media if the 
following conditions are true: 


If you choose to do this, perform the steps that are described in 
your entire system after a complete system loss—Checklist 20” on page 98 
recover your system. 


Data Loss: 


All 


User ASP Configured: 


Yes 


Basic User ASP Overflowed: 


Yes 


You have a large number of objects in your user ASPs 


2. You have thoroughly backed up your system 


“Recovering 


to 


Table 17. Recovery Checklist for Disk Failure—Checklist 10 


Task 


What To Do Where To Read More About It 


Actions to Be Performed by the Service Representative 


___ Task 1 


Physically remove the failed disk unit from 
the system. 


___ Task 2 


Delete the data in the ASP that contains the 
failed unit. When you delete the data in the 
system ASP, the system also deletes data in 
any basic user ASPs that have a status of 
overflowed. 


___ Task 3 


Install the replacement disk unit. 


___ Task 4 


Restore the Licensed Internal Code using 


___ Task 5 


Configure the replacement disk unit by 
selecting the ‘Replace configured unit’ 
function on the Work with Disk Units 
display. 


“How to Prepare for Loading the 


option 1 (Restore Licensed Internal Code). If |Licensed Internal Code” on page 124 


user ASPs are configured and are not and {How to Load the Licensed 
overflowed, they remain intact. Internal Code” on page 132 


Actions to Be Performed by the User 


___ Task 6 Restore the operating system, beginning with {Chapter 6, “Restoring the Operating 
“Task 1-Starting to Restore the Operating System”} task 1 through task 6. 
System” on page 150} You are performing a 
complete restore operation. 

___ Task 7 If you restored the operating system using “Recovering System Information” on| 


correct them if necessary. 


distribution media, some system information 
such as access path recovery times and the 

system reply list may have been reset to 

default values. Verify these values and 
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Table 17. Recovery Checklist for Disk Failure—Checklist 10 (continued) 


Task What To Do Where To Read More About It 

___ Task 8 If necessary, change the QALWOBJRST “Controlling Restoration of 
system value. Write the old value here: Security-Sensitive Objects” on page 52 

___ Task 9 If necessary, change the QVFYOBJRST “Controlling Restoration of 
system value. Write the old value here: Security-Sensitive Objects” on page 52 

___ Task 10 If necessary, change the system value that The System Values subtopic of the 
controls whether the job log wraps when it is System Management topic in the 
full. Use the Work with System Values iSeries Information Center. 
command: WRKSYSVAL QJOBMSGOEFL. 

Write down the current value here: 
. Then change the value to 
*PRTWRAP. 

Task 11 After changing the system values, sign off by 
using the command SIGNOFF *LIST. Then, 
using a newly created password, sign back 
on as QSECOFR for the new values to take 
effect. 

___ Task 12 Describe or diagram, as much as possible, “Describing the Contents of Your User 
the contents of your user ASPs before the Auxiliary Storage Pools” on page 185 
failure. 

___ Task 13 Recover user profiles, configuration, libraries |“How to Recover a Basic User ASP; 


After Recovering the System ASP” on 


task 1 through task 11. 


in the system ASP, and the contents of any 
basic user ASPs that were not in overflowed 
status. If you choose not to restore all of 
your libraries at this time, ensure that you 
restore the QGPL and QUSRSYS libraries 
along with the libraries that you are 
restoring. 


___ Task 14 Recover the objects in the basic user ASPs “How to Recover a Damaged Basic 

that were overflowed. Auxiliary Storage Pool” on page 200 
task 1 through task 9. 

___ Task 15 Restore document library objects to the “Restoring Documents and Folders” on| 
system ASP and to any overflowed basic page 262 
user ASPs that had DLOs. 

___ Task 16 Restore your last complete save of “Restoring Objects in Directories” 0 
directories.' page 268 

___ Task 17 If you have User-Defined File Systems in “Task 7—-Restoring User-Defined File 
User ASPs that do not restore correctly, you [Systems to the User Auxiliary Storage 
may need to perform additional recovery Pool” on page 191 
steps. 

___ Task 18 Restore changed objects and apply journaled {Chapter 11, “How to Restore Changed 
changes. Objects and Apply Journaled Changes” 

task 1 through task 7. 

___ Task 19 If you use Cryptographic Access Provider, “Recovery Considerations for 
install the Cryptographic Access Provider Cryptographic Access Provider” on 
licensed program (5769AC3) using option 11 
on the Work with Licensed Programs menu. 

___ Task 20 Restore authority. Type: RSTAUT “Restoring Object Authorities” on 

___ Task 21 Reapply any PTFs that were applied since “How to Restore Program Temporar 


your last SAVSYS operation. Fixes” on page 280 
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Table 17. Recovery Checklist for Disk Failure—Checklist 10 (continued) 


Task What To Do Where To Read More About It 
___ Task 22 If you use Windows server on iSeries and “Completing Recovery for the iSeries 


saved with the Integrated xSeries Server 
(NWSD) varied off, complete recovery for 
the Windows server on iSeries product. 


___ Task 23 If you run Linux and saved Linux by 
varying off the network server description 


(NWSD) for Linux, complete the recovery for 


Linux. 


Integration for Windows Server 


Product” on page 270 


“Recovering Linux in a Partition” on 


page 271 


___ Task 24 If necessary, change the QALWOBJRST 
system value back to its original value by 
using the WRKSYSVAL command. 


“Controlling Restoration of 


Security-Sensitive Objects” on page 52 


___ Task 25 If necessary, change the QVFYOBJRST 
system value back to its original value by 
using the WRKSYSVAL command. 


“Controlling Restoration of 


Security-Sensitive Objects” on page 52 


___ Task 26 If necessary, change the QIOBMSGQFL 
system value back to its original value by 
using the WRKSYSVAL command. 


The System Values subtopic of the 
System Management topic in the 
iSeries Information Center. 


___ Task 27 Perform either a: 
SIGNOFF *LIST 


ora 
DSPJOBLOG * *PRINT 


Check the job log to ensure all objects were 
restored. The job log contains information 


about the restore operation. To verify that all 


objects were restored, spool the job log for 
printing along with the job’s remaining 
spooled output, if any. 


Message CPC3703 is sent to the job log for 
each library that was successfully restored. 
Message CPF3773 is sent to tell you how 
many objects were restored. Objects are not 
restored for various reasons. Check for any 
error messages, correct the errors, and then 
restore those objects from the media. 


___ Task 28 You must perform a normal IPL at this “How to Perform™ a Normal IPL” onl 
time. page 61 
___ Task 29 If you use Windows server on iSeries and “Completing Recovery for the iSeries 


saved with the Integrated xSeries Server 


(NWSD) varied on, complete recovery for the 


Windows server on iSeries product. 


Integration for Windows Server 
Product” on page 270 


___ Task 30 If IBM Content Manager OnDemand for 
iSeries is installed, complete journaling for 


IBM Content Manager OnDemand for iSeries 


by typing the following commands: 
CALL QRDARS/QRLCSTRJ PARM('RLC') 


CALL QRDARS/QRLCSTRJ PARM('RLR') 
CALL QRDARS/QRLCSTRJ PARM('RLO') 


___ Task 31 Review job logs or output from your restore 


operations to ensure that all objects were 
restored successfully. 


“How to Verify That Objects Are 
Restored Successfully” on page 56 
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Table 17. Recovery Checklist for Disk Failure—Checklist 10 (continued) 


Task What To Do 


Where To Read More About It 


‘ You may receive one of the following messages: 


CPD377A: Object not restored, /QNTC. 
CPD377A: Object not restored, /QNetWare. 


These objects cannot be restored until their file systems have been mounted during the IPL. You may 
ignore these messages. The additional recovery tasks will guide you through the steps to restore these 


objects. 


Note: Since the OS/400 Enhanced Integration for Novell NetWare software resides on a remote server, you 
do not have to restore your Netware data when you restore your server. Previously, the OS/400 Integration 
for Novell NetWare product ran on a Integrated xSeries Server and you had to restore the Novell product 


if you completely restored your server. 


Actions for a failure in a basic ASP disk unit—Checklist 11 


This checklist should be used for the following problem situation: 


Failed Unit: 
Basic ASP 


Data Loss: 
Some 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 


do not apply in your situation. 


Table 18. Recovery Checklist for Disk Failure-Checklist 11 
What To Do 


Task 


Where To Read More About It 


Actions to Be Performed by the Service Representative 


___ Task 1 Save the disk unit. 
___ Task 2 Attach the new disk unit. 
___ Task 3 Restore the disk unit data. 


Actions to Be Performed by the User 


___ Task 4 You must perform an IPL at this time. Chapter 7, “Starting the System After It 
Follow the procedure for starting the system |Ends Abnormally”} task 1 through task 
after it ends abnormally. 4. 

___ Task 5 Reclaim storage. “Reclaiming Storage” on page 48 

___ Task 6 Evaluate the extent of the damage. “Task 4-Recovering from Damaged 
Determine whether you will attempt to Objects and Unreadable Sectors” on 
recover damaged objects or restore the entire 
system. Do not skip this step. 

___ Task 7 If you have decided to do a complete restore 
operation, use [Table 30 on page 107] to 
determine the correct procedure for 
recovering user information. 

__ Task 8 If you have decided to attempt to recover 


damaged objects, perform the tasks in 


Recovering from Damaged Objects and 
lUnreadable Sectors” on page 177 
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Actions for a failure in a basic ASP disk unit—Checklist 12 


This checklist should be used for the following problem situation: 


Failed Unit: 
Basic ASP Not in overflow status 


Data Loss: 
All 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Table 19. Recovery Checklist for Disk Failure—Checklist 12 


Task 


What To Do Where To Read More About It 


Actions to Be Performed by the Service Representative 


___ Task 1 Physically remove the failed disk unit from 
the system. 

___ Task 2 Delete the data in the ASP that contains the 
failed unit. 

___ Task 3 Install the replacement disk unit. 

___ Task 4 Configure the replacement disk unit by 


selecting the ‘Replace configured unit’ 
function on the Work with Disk Units 


display. 
Actions to Be Performed by the User 
___ Task 5 You must perform an IPL at this time. Chapter 7, “Starting the System After It 
Follow the procedure for starting the system |Ends Abnormally”} task 1 through task 
after it ends abnormally. 4. 
___ Task 6 Restore user profiles: RSTUSRPRF “Restoring User Profiles” on page 222 
USRPRF(*ALL) DEV(TAPO1) 
___ Task 7 If necessary, change the QALWOBJRST “Controlling Restoration of 
system value. Write the old value here: Security-Sensitive Objects” on page 52 
___ Task 8 If necessary, change the QVFYOBJRST “Controlling Restoration of 
system value. Write the old value here: Security-Sensitive Objects” on page 52 
___ Task 9 If necessary, change the system value that The System Values subtopic of the 
controls whether the job log wraps when it is System Management topic in the 
full. Use the Work with System Values iSeries Information Center. 


command: WRKSYSVAL QJOBMSGOQFL. 
Write down the current value here: 
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Table 19. Recovery Checklist for Disk Failure—Checklist 12 (continued) 


Task What To Do 


Where To Read More About It 


___ Task 10 After changing the system values, sign off by 
using the command SIGNOFF *LIST. Then, 
using a newly created password, sign back 
on as QSECOFR for the new values to take 
effect. 


___ Task 11 Recover the objects in the basic ASP. 


“How to Recover a Damaged Basic 
Auxiliary Storage Pool” on page 200 


task 1 through task 9. 


___ Task 12 If you have User-Defined File Systems in 
basic ASPs that do not restore correctly, you 
may need to perform additional recovery 
steps. 


“Task 7—Restoring User-Defined File 


Systems to the User Auxiliary Storage 
Pool” on page 191 


___ Task 13 Perform either a: 
SIGNOFF *LIST 


ora 
DSPJOBLOG * *PRINT 


Check the job log to ensure all objects were 
restored. The job log contains information 
about the restore operation. To verify that all 
objects were restored, spool the job log for 
printing along with the job’s remaining 
spooled output, if any. 


Message CPC3703 is sent to the job log for 
each library that was successfully restored. 
Message CPF3773 is sent to tell you how 
many objects were restored. Objects are not 
restored for various reasons. Check for any 
error messages, correct the errors, and then 
restore those objects from the media. 


___ Task 14 Restore changed objects to the basic ASP. Chapter 11, “How to Restore Changed 
Apply journaled changes to objects in the Objects and Apply Journaled Changes” 
basic ASP. task 1 through task 7. 

___ Task 15 If you use Cryptographic Access Provider, “Recovery Considerations for 


install the Cryptographic Access Provider 
licensed program (5769AC3) using option 11 
on the Work with Licensed Programs menu. 


Cryptographic Access Provider” on 


___ Task 16 Restore authority. Type: RSTAUT 


“Restoring Object Authorities” on| 
page 22 


___ Task 17 If necessary, change the QALWOBJRST 
system value back to its original value by 
using the WRKSYSVAL command. 


“Controlling Restoration of 


Security-Sensitive Objects” on page 52 


___ Task 18 If necessary, change the QVFYOBJRST 
system value back to its original value by 
using the WRKSYSVAL command. 


“Controlling Restoration of 


Security-Sensitive Objects” on page 52 


___ Task 19 If necessary, change the QROBMSGQFL 
system value back to its original value by 
using the WRKSYSVAL command. 


The System Values subtopic of the 
System Management topic in the 
iSeries Information Center. 


___ Task 20 You must perform an IPL at this time. 


“How to Perform™ a Normal IPL” onl 


page 6 


: 
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Table 19. Recovery Checklist for Disk Failure—Checklist 12 (continued) 


Task What To Do Where To Read More About It 
___ Task 21 Review job logs or output from your restore |“How to Verify That Objects Are 


operations to ensure that all objects were Restored Successfully” on page 56 


restored successfully. 


Actions for a failure in a basic ASP disk unit—Checklist 13 


This checklist should be used for the following problem situation: 


Failed Unit: 
Basic ASP in overflow status 


Data Loss: 
All 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Table 20. Recovery Checklist for Disk Failure—Checklist 13 


Task 


What To Do Where To Read More About It 


Actions to Be Performed by the Service Representative 


__ Task 1 Physically remove the failed disk unit from 
the system. 

___ Task 2 Delete the data in the ASP that contains the 
failed unit. 

___ Task 3 Install the replacement disk unit. 

___ Task 4 Configure the replacement disk unit by 


selecting the ‘Replace configured unit’ 
function on the Work with Disk Units 


display. 
Actions to Be Performed by the User 
___ Task 5 You must perform an IPL at this time. Chapter 7, “Starting the System After It 
Follow the procedure for starting the system |Ends Abnormally” on page 169 
after it ends abnormally. 
___ Task 6 Reclaim storage. “Reclaiming Storage” on page 48 
___ Task 7 Delete the overflowed objects. “How to Delete Overflowed Objects 
during Recovery” on page 200 
___ Task 8 If necessary, change the QALWOBJRST “Controlling Restoration of 
system value. Write the old value here: Security-Sensitive Objects” on page 52 
___ Task 9 If necessary, change the QVFYOBJRST “Controlling Restoration of 
system value. Write the old value here: Security-Sensitive Objects” on page 52 
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Table 20. Recovery Checklist for Disk Failure—Checklist 13 (continued) 


Task What To Do 


Where To Read More About It 


___ Task 10 If necessary, change the system value that 
controls whether the job log wraps when it is 
full. Use the Work with System Values 
command: WRKSYSVAL QJOBMSGOQEFL. 
Write down the current value here: 

. Then change the value to 
*PRTWRAP. 


The System Values subtopic of the 
System Management topic in the 
iSeries Information Center. 


___ Task 11 After changing the system values, sign off by 
using the command SIGNOFF *LIST. Then, 
using a newly created password, sign back 
on as QSECOFR for the new values to take 


effect. 
___ Task 12 Recover the objects in the basic ASP. “How to Recover a Damaged Basic 
Auxiliary Storage Pool” on page 200 
task 1 through task 9. 
___ Task 13 If you have User-Defined File Systems in “Task 7-Restoring User-Defined File 


User ASPs that do not restore correctly, you 
may need to perform additional recovery 


Systems to the User Auxiliary Storage 


Pool” on page 191 


steps. 

___ Task 14 Restore changed objects to the basic ASP. Chapter 11, “How to Restore Changed 
Apply journaled changes to objects in the Objects and Apply Journaled Changes” 
basic ASP. task 1 through task 7. 

___ Task 15 If you use Cryptographic Access Provider, “Recovery Considerations for 


install the Cryptographic Access Provider 
licensed program (5769AC3) using option 11 
on the Work with Licensed Programs menu. 


Cryptographic Access Provider” on| 


___ Task 16 Restore authority. Type: RSTAUT “Restoring Object Authorities” on 
___ Task 17 If necessary, change the QALWOBJRST “Controlling Restoration of 

system value. Security-Sensitive Objects” on page 52 
___ Task 18 If necessary, change the QVFYOBJRST “Controlling Restoration of| 

system value. Security-Sensitive Objects” on page 52 
___ Task 19 If necessary, change the QROBMSGQFL The System Values subtopic of the 


system value back to its original value by 
using the WRKSYSVAL command. 


System Management topic in the 
iSeries Information Center. 
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Table 20. Recovery Checklist for Disk Failure—Checklist 13 (continued) 


Task What To Do Where To Read More About It 


___ Task 20 Perform either a: 
SIGNOFF *LIST 


ora 
DSPJOBLOG * *PRINT 


Check the job log to ensure all objects were 
restored. The job log contains information 
about the restore operation. To verify that all 
objects were restored, spool the job log for 
printing along with the job’s remaining 
spooled output, if any. 


Message CPC3703 is sent to the job log for 
each library that was successfully restored. 
Message CPF3773 is sent to tell you how 
many objects were restored. Objects are not 
restored for various reasons. Check for any 
error messages, correct the errors, and then 
restore those objects from the media. 


___ Task 21 You must perform a normal IPL at this “How to Perform™ a Normal IPL” onl 


time. 
___ Task 22 Review job logs or output from your restore [How to Verify That Objects Are 


operations to ensure that all objects were Restored Successfully” on page 56 


restored successfully. 


Actions for non-load source disk unit failure—Checklist 14 


This checklist should be used for the following problem situation: 


Failed Unit: 
Any 


Mirrored Protection: 
Yes 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Note: For many failures, the system does not have to stopped and started again. 


The service representative can repair the failed component while the system 
continues to run. See|Chapter 12, “Mirrored Protection Recovery Actions” on 
[page 291] 
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Table 21. Recovery Checklist for Disk Failure-—Checklist 14 


Task 


What To Do Where To Read More About It 


Actions to Be Performed by the Service Representative 


__ Task 1 


Replace the failed disk unit. 


___ Task 2 


Resume mirrored protection. 


Actions to Be Performed by the User 


___ Task 3 


Ensure that disk configuration is correct. Chapter 22} “Working with Mirrored 
Protection”. 


Actions for non-load source disk unit failure—Checklist 15 


This checklist should be used for the following problem situation: 
Failed Unit: 
Any 


Device Parity Protection: 
Yes 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Note: For many failures, the system does not have to stopped and started again. 


The service representative can repair the failed component while the system 
continues to run. See |Chapter 21, “Working with Device Parity Protection” 


Table 22. Recovery Checklist for Disk Failure-Checklist 15 


Task 


What To Do Where To Read More About It 


Actions to Be Performed by the Service Representative 


___ Task 1 


Attach the new disk unit. 


___ Task 2 


Rebuild the failed device parity disk unit 
data. 


Actions to Be Performed by the User 


___ Task 3 


Ensure that disk configuration is correct. Chapter 21} “Working with Device 
Parity Protection”. 


Actions for non-load source disk unit failure—Checklist 16 


This checklist should be used for the following problem situation: 


Failed Unit: 
Non-Load source unit in system ASP 


Data Loss: 
N/A Disk unit cannot be replaced immediately 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 
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Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Table 23. Recovery Checklist for Disk Failure-—Checklist 16 


Task 


What To Do Where To Read More About It 


Actions to Be Performed by the User 


___ Task 1 Remove the failed disk unit from the 
configuration. 

___ Task 2 Restore the Licensed Internal Code 
using option 1 (Restore Licensed Licensed _ Internal Code” on page 124 
Internal Code). and 

Internal Code” on page 132) 

___ Task 3 Restore the operating system, 
beginning with System”} task 1 through task 6. 
You are performing a 
complete restore operation. 

___ Task 4 If you restored the operating system 
using distribution media, some 
system information, such as access 
path recovery times and the system 
reply list, may have been reset to 
default values. Verify these values 
and correct them if necessary. 

Tasks Use[Table30-on page T7}to 


determine the correct procedure for 
recovering user information. 


Actions for independent ASP disk failure—Checklist 17 


This checklist should be used for the following problem situation: 


Failed Unit: 
Disk unit in independent ASP 


Data Loss: 
None 


User ASP Configured: 
Yes 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 
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Table 24. Recovery Checklist for Disk Failure-Checklist 17 


Task 


What To Do Where To Read More About It 


Actions to Be Performed by the Service Representative 


__ Task 1 Save the disk unit data. 
___ Task 2 Attach a new disk unit. 
___ Task 3 Restore data to the new disk unit. 


Actions to Be Performed by the User 


___ Task 4 


Vary on the independent ASP. Use the VRYCFG command or the 
iSeries Navigator interface to vary on 
the independent ASP. 


Actions for a failure in an independent ASP disk 
unit—Checklist 18 


This checklist should be used for the following problem situation: 


Failed Unit: 
Independent ASP 


Data Loss: 
Some 


User ASP configured: 
Yes 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Table 25. Recovery Checklist for Disk Failure—Checklist 18 


Task What To Do Where To Read More About It 

Actions to Be Performed by the Service Representative 

___ Task 1 Save the disk unit. 

___ Task 2 Attach the new disk unit. 

___ Task 3 Restore the disk unit data. 

Actions to Be Performed by the User 

___ Task 4 You must vary on the independent ASP Use the VRYCFG command or the 
now. iSeries Navigator interface to vary on 

the independent ASP. 

___ Task 5 Reclaim storage. “Reclaiming Storage” on page 48 

___ Task 6 Evaluate the extent of the damage. “Task 4—-Recovering from Damaged 
Determine whether you will attempt to Objects and Unreadable Sectors” on 
recover damaged objects or restore the entire 
system. Do not skip this step. 

___ Task 7 If you have decided to proceed, continue “How to Recover an Independent ASP” 


with the restore operation for independent 
ASP data. 
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Actions for a failure in an independent ASP disk 
unit—Checklist 19 


This checklist should be used for the following problem situation: 


Failed Unit: 
Independent ASP 


Data Loss: 
All 


User ASP configured: 
Yes 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Table 26. Recovery Checklist for Disk Failure-—Checklist 19 


Task 


What To Do Where To Read More About It 


Actions to Be Performed by the Service Representative 


___ Task 1 Physically remove the failed disk unit from 
the system. 

___ Task 2 Delete the data in the ASP that contains the 
failed unit. 

___ Task 3 Install the replacement disk unit. 

___ Task 4 Configure the replacement disk unit by 


selecting the ‘Replace configured unit’ 
function on the Work with Disk Units 


display. 
Actions to Be Performed by the User 
___ Task 5 Vary on the IASP at this time. Use the VRYCFG command or the 
iSeries Navigator interface to vary on 
the independent ASP. 
___ Task 6 If necessary, change the QALWOBJRST “Controlling Restoration of 
system value. Write the old value here: Security-Sensitive Objects” on page 52 
___ Task 7 If necessary, change the QVFYOBJRST “Controlling Restoration of| 
system value. Write the old value here: Security-Sensitive Objects” on page 52 
___ Task 8 If necessary, change the system value that The System Values subtopic of the 
controls whether the job log wraps when it is System Management topic in the 
full. Use the Work with System Values iSeries Information Center. 


command: WRKSYSVAL QJOBMSGOFL. 
Write down the current value here: 
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Table 26. Recovery Checklist for Disk Failure—Checklist 19 (continued) 


Task What To Do Where To Read More About It 


Task 9 After changing the system values, sign off by 
an using the command SIGNOFF *LIST. Then, 
using a newly created password, sign back 
on as QSECOFR for the new values to take 
effect. 


___ Task 10 Recover the objects in the independent user |“How to Recover an Independent ASP” 
ASP. ion page 206 


Note: If you know which user profiles are 
authorized to objects in the independent 
ASP, you can specify the individual profiles 
and avoid restricting your system to process 
USRPREF *ALL. 


___ Task 11 Restore changed objects to the independent [Chapter 11, “How _to Restore Changed 


ASP. Objects and Apply Journaled Changes” 


___ Task 12 Restore authority. Type: RSTAUT “Restoring Object Authorities” on 


___ Task 13 Perform either a: 
SIGNOFF *LIST 


ora 
DSPJOBLOG * *PRINT 


Check the job log to ensure all objects were 
restored. The job log contains information 
about the restore operation. To verify that all 
objects were restored, spool the job log for 
printing along with the job’s remaining 
spooled output, if any. 


Message CPF3773 is sent to tell you how 
many objects were restored. Objects are not 
restored for various reasons. Check for any 
error messages, correct the errors, and then 
restore those objects from the media. 


___ Task 14 If necessary, change the QALWOBJRST “Controlling Restoration of 


system value back to its original value by Security-Sensitive Objects” on page 52 


using the WRKSYSVAL command. 


___ Task 15 If necessary, change the QVFYOBJRST “Controlling Restoration of| 
system value back to its original value by Security-Sensitive Objects” on page 52 
using the WRKSYSVAL command. 

___ Task 16 If necessary, change the QKOBMSGQFL The System Values subtopic of the 
system value back to its original value by System Management topic in the 
using the WRKSYSVAL command. iSeries Information Center. 

___ Task 17 Review job logs or output from your restore |“How to Verify That Objects Are 


operations to ensure that all objects were Restored Successfully” on page 56 


restored successfully. 


Recovering your entire system after a complete system 
loss—Checklist 20 


This checklist should be used if you need to restore your entire system to a system 
that is running the same version of the OS/400 licensed program. Do not use this 
checklist if you are performing a RISC to RISC upgrade. For information on 
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performing a RISC to RISC upgrade, refer to Installation, upgrades and migration 


in the iSeries Information Center at 


http:/ /www.ibm.com/eserver /iseries /infocenter. 


Note: If the system you must recover contains an independent ASP, refer to 
“Recovering your entire system after a complete system loss including 


independent ASPs-Checklist 21” on page 101 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 


in evaluating your backup strategy. 


Most steps in the checklist include references to 


other topics in this book. Refer to 


these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 


do not apply in your situation. 


Table 27. Recovery Checklist for Complete System Loss—Checklist 20 


Task What To Do Where To Read More About It 
Actions to Be Performed by the User 
___ Task 1 If you use V5R2 Operations Console To resynchronize a previous release 
with LAN connectivity, resynchronize of Operations Console, see the 
your PC device ID to match the Operations Console topic in the 
iSeries device ID. iSeries Information Center at 
1. In Operations Console select the http://www.ibm.com/eserver/ 
connection name for which you iseries /infocenter. 
will make the change. Select 
Connection --> Properties. 
2. Select the Device ID page. 
3. Specify the passwords in the 
Password and Confirm password 
fields, and click OK. 
4. Specify the Access password and 
click OK. 
___ Task 2 Prepare to load the Licensed Internal |“How to Prepare for Loading the 
Code. Licensed Internal Code” on page 124 
___ Task 3 Install the Licensed Internal Code “How to Prepare for Loading the 
using option 2 (Install Licensed Licensed Internal Code” on page 124 
Internal Code and Initialize System)'. and|“How to Load the Licensed 
Internal Code” on page 132 
___ Task 4 Configure the disk units (assign to Chapter 19, “Procedures for 
ASP and set up disk protection). If Configuring Disks and Disk 
you saved any User-Defined File Protection” on page 383|and 
Systems (UDFS), you must configure |Chapter 20, “Working with Auxiliary 
your user ASPs or the UDFS will not [Storage Pools” on page 403 
restore. 
___ Task 5 Restore the operating system, “How _to Restore the OS/400 


beginning “Task 1—-Starting to 


Restore the Operating System” on! 


You are performing a 
complete restore operation. 


Licensed Program” on page 149 
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Table 27. Recovery Checklist for Complete System Loss—Checklist 20 (continued) 


Task 


What To Do 


Where To Read More About It 


___ Task 6 


If you restored the operating system 
using distribution media, some 
system information, such as access 
path recovery times and the system 
reply list may have been reset to 
default values. Verify these values 
and correct them if necessary. 


“Recovering System Information” on 


page 221 


___ Task 7 


Recover user information from your 
save media. Restore changed objects 
and apply journal entries. If you are 
restoring to a different system, or a 
different logical partition, you must 
specify ALWOBJDIF(*ALL) on the 
RSTxxx commands. 

Note: If you use Backup Recovery 
and Media Services, refer to your 
Backup Recovery and Media Services 
recovery report to recover your user 
information. 


“Choosing the Procedure to Recover 
User Information” on page 10 


___ Task 8 


If you are not sure what the 
password is for the QSECOFR profile 
that was restored from tape, change 
it before signing off: CHGUSRPRF 
USRPRF (QSECOFR) 

PASSWORD (new-password) 


“What Happens When You Restore 
User Profiles” on page 223 


___ Task 9 


If you restored from distribution 
media, restore your system 
information to the correct settings. 


“Recovering System Information” on 


page 221 


___ Task 10 


Perform either a 
SIGNOFF *LIST 


ora 
DSPJOBLOG * *PRINT 


Check the job log to ensure that all 
objects were restored. The job log 
contains information about the 
restore operation. To verify that all 
objects were restored, spool the job 
log for printing along with the job’s 
remaining spooled output, if any. 


Message CPC3703 is sent to the job 
log for each library that was 
successfully restored. Message 
CPF3773 is sent to tell you how 
many objects were restored. Objects 
are not restored for various reasons. 
Check for any error messages, correct 
the error, and then restore those 
objects from the media. 


___ Task 11 


100 08/400 Backup and Recovery V5R2 


You must perform a normal IPL at 
this time. 


“How to Perform™ a Normal IPL” onl 


Table 27. Recovery Checklist for Complete System Loss—Checklist 20 (continued) 


Task What To Do Where To Read More About It 
___ Task 12 If you use Windows server on iSeries |“Completing Recovery for the iSeries 
and saved with the Integrated xSeries |Integration for Windows Server 
Server (NWSD) varied on, complete |Product” on page 270 
recovery for the Windows server on 
iSeries. 
___ Task 13 If IBM Content Manager OnDemand 
for iSeries is installed, complete 
journaling for IBM Content Manager 
OnDemand for iSeries by typing the 
following commands: 
CALL QRDARS/QRLCSTRJ PARM('RLC') 
CALL QRDARS/QRLCSTRJ PARM('RLR') 
CALL QRDARS/QRLCSTRJ PARM('RLO') 
___ Task 14 Review job logs or output from your [How to Verify That Objects Are 


restore operations to ensure that all [Restored Successfully” on page 56 


objects were restored successfully. 


Recovering your entire system after a complete system loss 
including independent ASPs—Checklist 21 


This checklist should be used if you need to restore your entire system that 
includes an independent ASP to a system that is running the same version of the 
OS/400 licensed program. Do not use this checklist if you are performing a RISC 
to RISC upgrade. For information on performing a RISC to RISC upgrade, refer to 
Installation, upgrades and migration in the iSeries Information Center at 

http: //www.ibm.com /eserver /iseries /infocenter. 


Note: If you are restoring a clustered system with independent ASPs, refer to the 
Clustering topic in the Information Center at 
www.ibm.com/eserver/iseries/infocenter, along with this checklist. 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Table 28. Recovery Checklist for Complete System Loss—Checklist 21 


Task 


What To Do Where To Read More About It 


Actions to Be Performed by the User 
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Table 28. Recovery Checklist for Complete System Loss—Checklist 21 (continued) 


Task What To Do Where To Read More About It 
___ Task 1 If you use V5R2 Operations Console To resynchronize a previous release 
with LAN connectivity, resynchronize of Operations Console, see the 
your PC device ID to match the Operations Console topic in the 
iSeries device ID. iSeries Information Center at 
1. In Operations Console select the http://www.ibm.com/eserver/ 
connection name for which you _iSeries/infocenter. 
will make the change. Select 
Connection --> Properties. 
2. Select the Device ID page. 
3. Specify the passwords in the 
Password and Confirm password 
fields, and click OK. 
4. Specify the Access password and 
click OK. 
___ Task 2 Prepare to load the Licensed Internal |“How to Prepare for Loading the 
Code". Licensed Internal Code” on page 124 
___ Task 3 Install the Licensed Internal Code “How to Prepare for Loading the 
using option 2 (Install Licensed Licensed Internal Code” on page 124 
Internal Code and Initialize System). and|“How to Load the Licensed 
Internal Code” on page 132) 
___ Task 4 Configure the disk units (assign to Chapter 19, “Procedures for| 
ASP and set up disk protection). If Configuring Disks and Disk 
you saved any User-Defined File Protection” on page 383/and 
Systems (UDFS), you must configure |Chapter 20, “Working with Auxiliar 
your user ASPs or the UDFS will not |Storage Pools” on page 403 
restore. 
Note: You will configure and restore 
independent ASPs in a later step. 
___ Task 5 Restore the operating system, “How to Restore the OS/400) 
beginning with|Task 1-Starting to! Licensed Program” on page 149 
Restore the Operating System” on 
You are performing a 
complete restore operation. 
___ Task 6 If you restored the operating system |Recovering System Information” on 


using distribution media, some 
system information, such as access 
path recovery times and the system 
reply list may have been reset to 
default values. Verify these values 
and correct them if necessary. 
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Table 28. Recovery Checklist for Complete System Loss—Checklist 21 (continued) 


Task 


What To Do 


Where To Read More About It 


___ Task 7 


Recover user information from your 
save media. Restore changed objects 
and apply journal entries. If you are 
restoring to a different system, or a 
different logical partition, you must 
specify ALWOBJDIF(*ALL) on the 
RSTxxx commands and 
SRM(*NONE) on the RSTCFG 
command. 

Note: You may want to wait to 
restore authorities until after you 
have configured the independent 
ASPs. You can also prompt on RSTAUT 
and. specify SAVASPDEV(*SYSBAS). This 
allows users to access objects in the 
system and basic ASPs, while you 
complete recovery procedures for the 
independent ASPs. Both options can 
eliminate restricting your server 
again. 

Note: If you use Backup Recovery 
and Media Services, refer to your 
Backup Recovery and Media Services 
recovery report to recover your user 
information. 


“Choosing the Procedure to Recover 
User Information” on page 10 


___ Task 8 


If you are not sure what the 
password is for the QSECOFR profile 
that was restored from tape, change 
it before signing off: CHGUSRPRF 
USRPRF (QSECOFR) 

PASSWORD (new-password) 


“What Happens When You Restore 
User Profiles” on page 223 


___ Task 9 


If you restored from distribution 
media, restore your system 
information to the correct settings. 


“Recovering System Information” on 
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Table 28. Recovery Checklist for Complete System Loss—Checklist 21 (continued) 


Task What To Do Where To Read More About It 

___ Task 10 Perform either a 
SIGNOFF *LIST 
ora 
DSPJOBLOG *« *PRINT 
Check the job log to ensure that all 
objects were restored. The job log 
contains information about the 
restore operation. To verify that all 
objects were restored, spool the job 
log for printing along with the job’s 
remaining spooled output, if any. 

Message CPC3703 is sent to the job 
log for each library that was 
successfully restored. Message 
CPF3773 is sent to tell you how 
many objects were restored. Objects 
are not restored for various reasons. 
Check for any error messages, correct 
the error, and then restore those 
objects from the media. 

__ Task 11 Configure the Service Tools Server for See Security > Service Tools in the 
OS/400 in order to access disk iSeries Information Center at 
management functions. http://www.ibm.com/eserver/ 

iseries /infocenter. 
___ Task 12 You must perform a normal IPL at __ [How to Perform'” a Normal IPL” on] 
this time. 
___ Task 13 If you use Windows server on iSeries |“Completing Recovery for the iSeries 
and saved with the Integrated xSeries |Integration for Windows Server 
Server (NWSD) varied on, complete |Product” on page 270 
recovery for the Windows server on 
iSeries. 
___ Task 14 Configure independent ASPs through iSeries Navigator online help for disk 
iSeries Navigator. units. 
___ Task 15 Verify the RESOURCE and make the Use the vary configuration (VRYCFG) 
independent ASP available now. This command in the character-based 
will create a directory for the interface, or the make available 
independent ASP and automatically function in iSeries Navigator. 
mount the UDFS to that directory. 
___ Task 16 Restore independent ASP data. “How to Recover an Independent 
ASP” on page 206 

___ Task 17 Restore authority. Type: RSTAUT “Restoring Object Authorities” on| 
page 227 

___ Task 18 If IBM Content Manager OnDemand 


for iSeries is installed, complete 
journaling for IBM Content Manager 
OnDemand for iSeries by typing the 
following commands: 

CALL QRDARS/QRLCSTRJ PARM('RLC') 
CALL QRDARS/QRLCSTRJ PARM('RLR') 
CALL QRDARS/QRLCSTRJ PARM('RLO') 
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Table 28. Recovery Checklist for Complete System Loss—Checklist 21 (continued) 


Task What To Do Where To Read More About It 

___ Task 19 Review job logs or output from your {How to Verify That Objects Are 
restore operations to ensure that all Restored Successfully” on page 56 
objects were restored successfully. 

___ Task 20 When you are ready to start 


clustering on the node you just 
recovered, you must start clustering 
from the active node. This will 
propagate the most current 
configuration information to the 
recovered node. 


Restoring a Logical Partition to Another Logical 
Partition—Checklist 22 


This checklist should be used if you need to restore one logical partition to 
another. If you have independent ASPs configured in your logical parition, refer to 


“Recovering your entire system after a complete system loss including independent 
ASPs—Checklist 21” on page 101/as well. 


Before you begin your recovery, make a copy of this checklist. Fill in the 
appropriate areas as you and the service representative perform the recovery steps. 
This checklist provides an important record of your recovery actions. It may help 
you to diagnose any problems that occur after the recovery. It may also be useful 
in evaluating your backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects, if they 
do not apply in your situation. 


Table 29. Recovery Checklist for Complete System Loss—Checklist 23 


Task 


What To Do Where To Read More About It 


Actions to Be Performed by the User 


___ Task 1 Prepare to load the Licensed Internal |“How to Prepare for Loading the 
Code". Licensed Internal Code” on page 124 

___ Task 2 Install the Licensed Internal Code “How to Prepare for Loading the 
using option 3 (Install Licensed Licensed Internal Code” on page 124 
Internal Code and Recover and|“How to Load the Licensed 
Configuration). Internal Code” on page 132) 

___ Task 3 Configure the disk units (assign to Chapter 19, “Procedures for 
ASP and set up disk protection). If Configuring Disks and Disk 
you saved any User-Defined File Protection” on page 383}and 
Systems (UDFS), you must configure |Chapter 20, “Working with Auxiliar 
your user ASPs or the UDFS will not [Storage Pools” on page 403 
restore. 

___ Task 4 “How to Restore the OS/400 


Licensed Program” on page 149 


complete restore operation. 
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Table 29. Recovery Checklist for Complete System Loss—Checklist 23 (continued) 


Task What To Do Where To Read More About It 
___ Task 5 If you restored the operating system |Recovering System Information” on 
using distribution media, some page 221 
system information, such as access 
path recovery times and the system 
reply list may have been reset to 
default values. Verify these values 
and correct them if necessary. 
___ Task 6 Recover user information from your |“Choosing the Procedure to Recover 


___ Task 7 


save media. Restore changed objects 
and apply journal entries. If you are 
restoring to a different system, or a 
different logical partition, you must 
specify ALWOBJDIF(*ALL) on the 
RSTxxx commands. 


If you are not sure what the 


password is for the QSECOFR profile 


that was restored from tape, change 
it before signing off: CHGUSRPRF 
USRPRF (QSECOFR) 

PASSWORD (new-password) 


User Information” on page 10 


“What Happens When You Restore 
User Profiles” on page 223 


___ Task 8 


If you restored from distribution 
media, restore your system 
information to the correct settings. 


“Recovering System Information” on 


___ Task 9 


Perform either a 
SIGNOFF *LIST 


ora 
DSPJOBLOG * *PRINT 


Check the job log to ensure that all 
objects were restored. The job log 
contains information about the 
restore operation. To verify that all 
objects were restored, spool the job 
log for printing along with the job’s 
remaining spooled output, if any. 


Message CPC3703 is sent to the job 
log for each library that was 
successfully restored. Message 
CPF3773 is sent to tell you how 
many objects were restored. Objects 
are not restored for various reasons. 


Check for any error messages, correct 


the error, and then restore those 
objects from the media. 


___ Task 10 


You must perform a normal IPL at 
this time. 


“How to Perform a Normal IPL” on 


__ Task 11 


If you use Windows server on iSeries 
and saved with the Integrated xSeries 


Server (NWSD) varied on, complete 
recovery for the Windows server on 
iSeries product. 


“Completing Recovery for the iSeries 
Integration for Windows Server 


Product” on page 270 
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Table 29. Recovery Checklist for Complete System Loss—Checklist 23 (continued) 


Task 


What To Do 


Where To Read More About It 


___ Task 12 


If IBM Content Manager OnDemand 
for iSeries is installed, complete 
journaling for IBM Content Manager 
OnDemand for iSeries by typing the 
following commands: 
CALL QRDARS/QRLCSTRJ PARM('RLC') 


CALL QRDARS/QRLCSTRJ PARM('RLR') 
CALL QRDARS/QRLCSTRJ PARM('RLO') 


___ Task 13 


Review job logs or output from your {How to Verify That Objects Are 
restore operations to ensure that all Restored Successfully” on page 56 


objects were restored successfully. 


Choosing the Procedure to Recover User Information 


Table 30. Choosing the Correct Recovery Procedure for User Information 


Your first step in a recovery is to return your system to a normal operating 
condition. This may require: 


* Replacing hardware 


* Restoring or installing the Licensed Internal Code 


* Performing an IPL after the system ends abnormally 


When _your system is running normally, you are ready to recover user information. 


Use 


Table 30}to determine the procedure you should follow. In the table, N/A in a 


column means that the recovery procedure is the same, whether you respond yes 


or no. 


Do You Have Do You Want to 
Are You Save SAVCHGOBJs or | Use Menu 
Recovering All | Procedure Journals to Options to 
ASPs? Used Apply? Recover? Recovery Procedure to Follow 
Yes Commands N/A See note 1. “Recovering User Information Using 
(Commands-Checklist 24” on page 108 
Yes Save menu No Yes “Using Option 21 from the Restore 
option 21 IMenu-Checklist 25” on page 112 
Yes Save menu Yes N/A “Recovering User Information Using 
option 21 (Commands-—Checklist 24” on page 108 
Yes Save menu No No “Recovering User Information Using 
option 21 (Commands-—Checklist 24” on page 108 
Yes Save menu No Yes “Using Options 22 and 23 from the Restore 
option 22 IMenu-Checklist 26” on page 114 
Save menu 
option 23 
Yes Save menu Yes N/A “Recovering User Information Using 
option 22 (Commands-—Checklist 24” on page 108 
Save menu 
option 23 
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Table 30. Choosing the Correct Recovery Procedure for User Information (continued) 


Do You Have Do You Want to 
Are You Save SAVCHGOBJs or | Use Menu 
Recovering All | Procedure Journals to Options to 
ASPs? Used Apply? Recover? Recovery Procedure to Follow 
Yes Save menu No No “Recovering User Information Using 
option 22 (Commands-—Checklist 24” 
Save menu 
option 23 
Yes Save menu No Yes “Using Options 22 and 23 from the Restore 
option 21 Menu-Checklist 26” on page 114 
Save menu 
option 23 
Yes Save menu Yes N/A “Recovering User Information Using 
option 21 (Commands-—Checklist 24” 
Save menu 
option 23 
Yes Save menu No No “Recovering User Information Using 
option 21 (Commands-—Checklist 24” 
Save menu 
option 23 
Yes Operational N/A N/A “Recovering User Information Using Tapes 
Assistant from Operational Assistant 
Backup” Backup—Checklist 27” on page 117 
No Any N/A N/A “Recovering User Information Using 
(Commands-—Checklist 24” 


If you save using commands rather than menu options, you should recover using commands. 


You have saved using either the RUNBCKUP command or the Run Backup menu. 


Recovering User Information Using Commands—Checklist 24 


This checklist shows the sequence of steps you should use to recover user 
information using commands. You may need to perform some tasks more than 
once. The correct steps for your situation depend on: 


* How you saved your information. 


* Whether you use journaling or whether applications you have purchased use 
journaling. 


* Whether you have document library objects. 


* Whether you save changed objects. 


Before you begin recovering user information, make a copy of this checklist. Fill 
in the appropriate areas as you perform the recovery steps. This checklist provides 
an important record of your recovery actions. It may help you diagnose any 
problems that occur after the recovery. It may also be useful in evaluating your 
backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
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You may not need to perform some steps, such as restoring changed objects and 
applying journal changes, if they do not apply in your situation. 


r Restoring to a Different System or Different Logical Partition? 
* You must specify ALWOBUDIF(*ALL) on the RSTxxx commands. 
* You must specify SRM(*NONE) on the RSTCFG command. 
* Network attributes may be reset to the IBM-supplied defaults. 


Table 31. Checklist for Recovering User Information Using Commands 


Task What To Do Where To Read More About It 


___ Task 1 If your system is not already ina restricted |“Putting Your System in a Restricted 


state, ensure that all users are off the system |State” on page 47 
and that all jobs are ended. Then type ENDSBS 
SBS(*ALL) OPTION(*CNTRLD) DELAY (600) 22. 


“Controlling Restoration of 


Security-Sensitive Objects” on page 52 


___ Task 2 If necessary, change the QALWOBJRST 
system value. Write the old value here: 


___ Task 3 If necessary, change the QVFYOBJRST 
system value. Write the old value here: 


“Controlling Restoration of 


Security-Sensitive Objects” on page 52 


___ Task 4 If necessary, change the system value that The System Values subtopic of the 
controls whether the job log wraps when it is System Management topic in the 
full. Use the Work with System Values iSeries Information Center. 


command: WRKSYSVAL QJOBMSGOQFL. 
Write down the current value here: 

. Then change the value to 
*PRTWRAP. 


Task 5 After changing the system values, sign off by 
using the command SIGNOFF *LIST. Then, 
using a newly created password, sign back 
on as QSECOFR for the new values to take 
effect. 


“How to Set the OPFRADJ System) 
Value for a Different Processor or 


Memory” on page 55 


___ Task 6 If restoring to a system with a different 
processor or memory, ensure the 
QMCHPOOL, QBASPOOL, and QPFRADJ 
system values are correct by using the 
WRKSYSVAL command. 


Task 7 Prevent messages that are not related to the 
—_ recovery from interrupting by typing: 
CHGMSGQ MSGQ(QSYSOPR) DLVRY(*NOTIFY) 
SEV (99) 


What ENDOPT? 


When you are restoring from tape, you tell the system whether or not to rewind the tape. If you are using tape in 
the tasks that follow, specify ENDOPT(*LEAVE) when you have additional steps. Specify ENDOPT(*REWIND) for your last 
step. 


___ Task 8 Restore user profiles: RSTUSRPRF DEV(TAPQ1) |“Restoring User Profiles” on page 222 


USRPRF (*ALL) 
___ Task 9 Restore device configuration: RSTCFG “How to Restore Configuration 
OBJ(*ALL) OBJTYPE(*ALL) DEV(TAPO@1) Objects” on page 235 
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Table 31. Checklist for Recovering User Information Using Commands (continued) 


Task What To Do Where To Read More About It 

___ Task 10 Restore the libraries to each ASP that you are |“Restoring Libraries” on page 240 
recovering. If you choose not to restore all of 
your libraries at this time, ensure that you 
restore the QGPL and QUSRSYS libraries 
along with the libraries that you are 
restoring. When recovering the entire system, 
there is no need to restore QGPL and 
QUSRSYS libraries first. 

___ Task 11 Restore the ownership for DLOs in the user |“Task 8—Reclaiming Document Library 
ASPs you are restoring. Objects” on page 192| 

___ Task 12 Restore your last complete save of document |“Restoring Documents and Folders” on 
library objects to each user ASP you are 
recovering. 

___ Task 13 Restore your last complete save of “Restoring Objects in Directories” o 
directories.° 

___ Task 14 If you have User-Defined File Systems in “Task 7—-Restoring User-Defined File 
User ASPs that do not restore correctly, you [Systems to the User Auxiliary Storage 
may need to perform additional recovery Pool” on page 191 
steps. 

___ Task 15 Restore changed objects and apply journaled {Chapter 11, “How _to Restore Changed 
changes. Objects and Apply Journaled Changes” 

task 1 through task 7. 

___ Task 16 If you use Cryptographic Access Provider, “Recovery Considerations for 
install the Cryptographic Access Provider Cryptographic Access Provider” on 
licensed program (5769AC3) using option 11 
on the Work with Licensed Programs menu. 

___ Task 17 Restore authority. Type: RSTAUT “Restoring Object Authorities” on 
Note: If you are restoring independent ASPs, 
you can prompt on RSTAUT and specify 
SAVASPDEV(*SYSBAS). This allows users access 
to objects in the system and basic ASPs, 
while you complete recovery procedures for 
the independent ASPs. 

___ Task 18 Reapply any PTFs that were applied since “How to Restore Program Temporary 
your last SAVSYS operation. Fixes” on page 280 

___ Task 19 If you use Windows server on iSeries and “Completing Recovery for the iSeries 
saved with the Integrated xSeries Server Integration for Windows Server 
(NWSD) varied off, complete recovery for Product” on page 270 
the Windows server on iSeries. 

___ Task 20 If you run Linux and saved Linux by “Recovering Linux in a Partition” on| 
varying off the network server description page 271 
(NWSD) for Linux, complete the recovery for 
Linux. 

___ Task 21 If necessary, change the QALWOBJRST “Controlling Restoration of 
system value back to its original value by Security-Sensitive Objects” on page 52 
using the WRKSYSVAL command. 

___ Task 22 If necessary, change the QVFYOBJRST “Controlling Restoration of 
system value back to its original value by Security-Sensitive Objects” on page 52 
using the WRKSYSVAL command. 

___ Task 23 If necessary, change the QKOBMSGQFL The System Values subtopic of the 
system value back to its original value by System Management topic in the 
using the WRKSYSVAL command. iSeries Information Center. 
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Table 31. Checklist for Recovering User Information Using Commands (continued) 


Task 


What To Do Where To Read More About It 


___ Task 24 


If you are recovering from a complete system 
loss, return to the appropriate checklist. 
Continue with the tasks on that checklist. 


___ Task 25 


Perform either a: 
SIGNOFF *LIST 


ora 
DSPJOBLOG * *PRINT 


Check the job log to ensure all objects were 
restored. The job log contains information 
about the restore operation. To verify that all 
objects were restored, spool the job log for 
printing along with the job’s remaining 
spooled output, if any. 


Message CPC3703 is sent to the job log for 
each library that was successfully restored. 
Message CPF3773 is sent to tell you how 
many objects were restored. Objects are not 
restored for various reasons. Check for any 
error messages, correct the errors, and then 
restore those objects from the media. 


___ Task 26 


You must perform a normal IPL at this “How to Perform™ a Normal IPL” onl 


time. 


___ Task 27 


If you use Windows server on iSeries and 
saved with the Integrated xSeries Server 
(NWSD) varied on, complete recovery for the 
Windows server on iSeries. 


Integration for Windows Server 


Product” on page 270 


“Completing Recovery for the iSeries 


___ Task 28 


If IBM Content Manager OnDemand for 
iSeries is installed, complete journaling for 
IBM Content Manager OnDemand for iSeries 
by typing the following commands: 

CALL QRDARS/QRLCSTRJ PARM('RLC') 


CALL QRDARS/QRLCSTRJ PARM('RLR') 
CALL QRDARS/QRLCSTRJ PARM('RLO') 


___ Task 29 


Review job logs or output from your restore |“How to Verify That Objects Are 
operations to ensure that all objects were Restored Successfully” on page 56 


restored successfully. 
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Table 31. Checklist for Recovering User Information Using Commands (continued) 


Task What To Do Where To Read More About It 


‘ Your system must be in a restricted state to restore user profiles. Other steps in the recovery may not 


require a restricted state. However, to ensure the success of your recovery and better performance when 
you are restoring information, a restricted state is recommended. 


For the delay parameter, specify a number of seconds that allows your system time to bring most jobs to a 
normal end. On a large, busy system, you may need a longer delay. 


You may receive one of the following messages: 


CPD377A: Object not restored, /QNTC. 
CPD377A: Object not restored, /QNetWare. 


These objects cannot be restored until their file systems have been mounted during the IPL. The additional 
recovery tasks will guide you through the steps to restore these objects. 

Note: Since the OS/400 Enhanced Integration for Novell NetWare resides on a remote server, you do not 
have to restore your Netware data when you restore your server. Previously, the OS/400 Integration for 
Novell NetWare product ran on a Integrated xSeries Server and you had to restore the Novell product if 
you completely restored your server. 


Using Option 21 from the Restore Menu—Checklist 25 


This checklist shows the sequence of steps you should use to recover user 
information using option 21 from the Restore menu. Option 21 restores your 
system to your last complete save. 


Before you begin recovering user information, make a copy of this checklist. Fill 
in the appropriate areas as you perform the recovery steps. This checklist provides 
an important record of your recovery actions. It may help you diagnose any 
problems that occur after the recovery. It may also be useful in evaluating your 
backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects and 
applying journal changes, if they do not apply in your situation. 


;— Restoring to a Different System? 
If you are restoring to a different system or to a different logical partition, be 
aware of the following: 


* You must specify ALWOBJDIF(*ALL) on the RSTxxx commands. 
* You must specify SRM(*NONE) on the RSTCFG command. 
* Network attributes may be reset to the IBM-supplied defaults. 


Note: An option is available on the restore menu that indicates that you are 
restoring to a different system. If you selected this option, the system 
automatically specifies the first two items that are listed above. You 
should also specify this option if you are restoring to a different logical 
partition. 
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Table 32. Checklist for Recovering User Information Using Option 21 


Task What To Do Where To Read More About It 

___ Task 1 If necessary, change the QALWOBJRST 
system value. Write the old value here: Security-Sensitive Objects” on page 52 

___ Task 2 If necessary, change the QVFYOBJRST 
system value. Write the old value here: Security-Sensitive Objects” on page 52 

___ Task 3 If necessary, change the system value that The System Values subtopic of the 
controls whether the job log wraps when it is System Management topic in the 
full. Use the Work with System Values iSeries Information Center. 
command: WRKSYSVAL QJOBMSGOFL. 

Write down the current value here: 
. Then change the value to 
*PRTWRAP. 

Task 4 After changing the system values, sign off by 
using the command SIGNOFF *LIST. Then, 
using a newly created password, sign back 
on as QSECOFR for the new values to take 
effect. 

___ Task 5 If restoring to a system with a different 
processor or memory, ensure the 
QMCHPOOL, QBASPOOL, and QPFRADJ Memory” on page 55 
system values are correct by using the 
WRKSYSVAL command. 

Task 6 Perform option 21 from the Restore menu. 

a Use your most recent tapes from performing |22, and 23” on page 216 
option 21 on the Save menu. If you are 
recovering using 
and restoring 
to a different system, use the "Restore to 
different system” option on the Specify 
Command Defaults display. You should 
also use this option if you restoring to a 
different logical partition. This option will 
automatically specify ALWOBJDIF(@ALL) 
on the RSTxxx commands and 
SRM(*NONE) on the RSTCFG command.’ 

___ Task 7 If you use Windows server on iSeries and 
saved with the Integrated xSeries Server 
(NWSD) varied off, complete recovery for Product” on page 270 
the Windows server on iSeries product. 

___ Task 8 If you run Linux and saved Linux by 
varying off the network server description 
(NWSD) for Linux, complete the recovery for 
Linux. 

___ Task 9 If you have User-Defined File Systems in 
User ASPs that do not restore correctly, you 
may need to perform additional recovery 
steps. 

___ Task 10 Reapply any PTFs that were applied since 


your last SAVSYS operation. 


Fixes” on page 280 
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Table 32. Checklist for Recovering User Information Using Option 21 (continued) 


Task What To Do Where To Read More About It 

__ Task 11 If necessary, change the QALWOBJRST “Controlling Restoration of| 
system value back to its original value by Security-Sensitive Objects” on page 52 
using the WRKSYSVAL command. 

___ Task 12 If necessary, change the QVFYOBJRST “Controlling Restoration of| 
system value back to its original value by Security-Sensitive Objects” on page 52 
using the WRKSYSVAL command. 

___ Task 13 If necessary, change the QROBMSGQFL The System Values subtopic of the 
system value back to its original value by System Management topic in the 
using the WRKSYSVAL command. iSeries Information Center. 

___ Task 14 If you are recovering from_a complete system 


loss, return to 
system after a complete system 
lloss—Checklist 20” on page 98} Continue with 


task 7 on that checklist. 


___ Task 15 You must perform a normal IPL at this “How to Perform™ a Normal IPL” on] 


time. page 6 


: 


“Completing Recovery for the iSeries 
Integration for Windows Server 
Product” on page 270 


___ Task 16 If you use Windows server on iSeries and 
saved with the Integrated xSeries Server 
(NWSD) varied on, complete recovery for the 
Windows server on iSeries product. 


___ Task 17 If IBM Content Manager OnDemand for 
iSeries is installed, complete journaling for 
IBM Content Manager OnDemand for iSeries 
by typing the following commands: 
CALL QRDARS/QRLCSTRJ PARM('RLC') 
CALL QRDARS/QRLCSTRJ PARM('RLR') 
CALL QRDARS/QRLCSTRJ PARM('RLO') 


___ Task 18 Review job logs or output from your restore |“How to Verify That Objects Are 
operations to ensure that all objects were Restored Successfully” on page 56 


restored successfully. 


You may receive one of the following messages: 


CPD377A: Object not restored, /QNTC. 
CPD377A: Object not restored, /QNetWare. 


These objects cannot be restored until their file systems have been mounted during the IPL. The additional 
recovery tasks will guide you through the steps to restore these objects. 

Note: Since the OS/400 Enhanced Integration for Novell NetWare resides on a remote server, you do not 
have to restore your Netware data when you restore your server. Previously, the OS/400 Integration for 
Novell NetWare product ran on a Integrated xSeries Server and you had to restore the Novell product if 
you completely restored your server. 


Using Options 22 and 23 from the Restore Menu—Checklist 26 


This checklist shows the sequence of steps you should use to recover user 
information using option 22 and 23 from the restore menu. Option 22 restores your 
IBM-supplied libraries to your last save. Option 23 restores your user libraries to 
your last save. 


Before you begin recovering user information, make a copy of this checklist. Fill 
in the appropriate areas as you perform the recovery steps. This checklist provides 
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an important record of your recovery actions. It may help you diagnose any 
problems that occur after the recovery. It may also be useful in evaluating your 
backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects and 
applying journal changes, if they do not apply in your situation. 


Table 33. Checklist for Recovering User Information Using Options 22 and 23 


Task What To Do Where To Read More About It 
Task 1 If necessary, change the QALWOBJRST 
_ system value back to its original value by Security-Sensitive Objects” on page 52 
using the WRKSYSVAL command. Write the 
old value here: 
Task 2 If necessary, change the QVFYOBJRST 
_— system value back to its original value by Security-Sensitive Objects” on page 52 
using the WRKSYSVAL command. Write the 
old value here: 
Task 3 If necessary, change the system value that The System Values subtopic of the 
— controls whether the job log wraps when it is System Management topic in the 
full. Use the Work with System Values iSeries Information Center. 
command: WRKSYSVAL QJOBMSGOQFL. 
Write down the current value here: 
. Then change the value to 
*PRTWRAP. 
Task 4 After changing the system values, sign off by 
using the command SIGNOFF *LIST. Then, 
using a newly created password, sign back 
on as QSECOFR for the new values to take 
effect. 
___ Task 5 If restoring to a system with a different 
processor or memory, ensure the 
QMCHPOOL, QBASPOOL, and QPFRADJ Memory” on page 55 
system values are correct by using the 
WRKSYSVAL command. 
___ Task 6 Perform option 22 from the Restore menu to 


restore IBM-supplied libraries and 22, and 23” on page 216 
directories. Use your most recent tapes from 
performing either option 21 or option 22 on 
the Save menu. If you are recovering using 


and restoring to a different system, 
use the "Restore to different system” option 
on the Specify Command Defaults display. 
You should also use this option if you 
restoring to a different logical partition. 
This option will automatically specify 
ALWOBJDIF(*ALL) on the RSTxxx 
commands and SRM(*NONE) on the 
RSTCFG command.* 
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Table 33. Checklist for Recovering User Information Using Options 22 and 23 (continued) 


Task 


What To Do 


Where To Read More About It 


___ Task 7 


Perform option 23 from the Restore menu to 
restore user libraries and user directories. 
Use your most recent tapes from performing 
either option 21 or option 23 on the Save 
menu. If you are recovering using 


and restoring to a different system, 
use the "Restore to different system” option 
on the Specify Command Defaults display. 
You should also use this option if you 
restoring to a different logical partition. 
This option will automatically specify 
ALWOBJDIF(*ALL) on the RSTxxx 
commands and SRM(*NONE) on the 
RSTCFG command.* 


“How to Use Restore Menu Options 21, 


22, and 23” on page 216 


___ Task 8 


If you use Windows server on iSeries and 
saved with the Integrated xSeries Server 
(NWSD) varied off, complete recovery for 
the Windows server on iSeries product. 


“Completing Recovery for the iSeries 


Integration for Windows Server 
Product” on page 270 


___ Task 9 


___ Task 10 


If you run Linux and saved Linux by 
varying off the network server description 
(NWSD) for Linux, complete the recovery for 
Linux. 


If you have User-Defined File Systems in 
User ASPs that do not restore correctly, you 
may need to perform additional recovery 
steps. 


“Recovering Linux in a Partition” on 
page 271 


“Task 7-Restoring User-Defined File 
Systems to the User Auxiliary Storage 
Pool” on page 191 


system value back to its original value by 
using the WRKSYSVAL command. 


___ Task 11 Reapply any PTFs that were applied since “How to Restore Program Temporar 
your last SAVSYS operation. Fixes” on page 280 
___ Task 12 If necessary, change the QALWOBJRST “Controlling Restoration of 
system value. Security-Sensitive Objects” on page 52 
__ Task 13 If necessary, change the QVFYOBJRST 
system value. 
___ Task 14 If necessary, change the QROBMSGQFL The System Values subtopic of the 


System Management topic in the 
iSeries Information Center. 
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Table 33. Checklist for Recovering User Information Using Options 22 and 23 (continued) 


Task 


What To Do Where To Read More About It 


___ Task 15 


Perform either a: 
SIGNOFF *LIST 


ora 
DSPJOBLOG * *PRINT 


Check the job log to ensure all objects were 
restored. The job log contains information 
about the restore operation. To verify that all 
objects were restored, spool the job log for 
printing along with the job’s remaining 
spooled output, if any. 


Message CPC3703 is sent to the job log for 
each library that was successfully restored. 
Message CPF3773 is sent to tell you how 
many objects were restored. Objects are not 
restored for various reasons. Check for any 
error messages, correct the errors, and then 
restore those objects from the media. 


___ Task 16 


You must perform a normal IPL at this “How to Perform™ a Normal IPL” onl 


time. 


___ Task 17 


If you use Windows server on iSeries and 
saved with the Integrated xSeries Server 
(NWSD) varied on, complete recovery for the 
Windows server on iSeries product. 


Integration for Windows Server 


Product” on page 270 


“Completing Recovery for the iSeries 


___ Task 18 


If IBM Content Manager OnDemand for 
iSeries is installed, complete journaling for 
IBM Content Manager OnDemand for iSeries 
by typing the following commands: 

CALL QRDARS/QRLCSTRJ PARM('RLC') 

CALL QRDARS/QRLCSTRJ PARM('RLR') 

CALL QRDARS/QRLCSTRJ PARM('RLO') 


___ Task 19 


Review job logs or output from your restore |“How to Verify That Objects Are 
operations to ensure that all objects were Restored Successfully” on page 56 


restored successfully. 


You may receive one of the following messages: 


CPD377A: Object not restored, /QNTC. 
CPD377A: Object not restored, /QNetWare. 


These objects cannot be restored until their file systems have been mounted during the IPL. The additional 


recovery tasks will guide you through the steps to restore these objects. 


Note: Since the OS/400 Enhanced Integration for Novell NetWare resides on a remote server, you do not 


have to restore your Netware data when you restore your server. Previously, the OS/400 Integration for 


Novell NetWare product ran on a Integrated xSeries Server and you had to restore the Novell product if 


you completely restored your server. 


Recovering User Information Using Tapes from Operational 
Assistant Backup—Checklist 27 


This checklist shows the sequence of steps you should use to recover user 
information when you have saved using Operational Assistant backup. These 
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procedures assume that all of your backup is done using Operational Assistant. 
You have not mixed Operational Assistant backup with other save methods. 


Before you begin recovering user information, make a copy of this checklist. Fill 
in the appropriate areas as you perform the recovery steps. This checklist provides 
an important record of your recovery actions. It may help you diagnose any 
problems that occur after the recovery. It may also be useful in evaluating your 
backup strategy. 


Most steps in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular step. 
You may not need to perform some steps, such as restoring changed objects and 
applying journal changes, if they do not apply in your situation. 


;— Restoring to a Different System? 
If you are restoring to a different system or to a different logical partition, be 
aware of the following: 


* You must specify ALWOBJDIF(*ALL) on the RSTxxx commands. 
* You must specify SRM(*NONE) on the RSTCFG command. 
* Network attributes are reset to the IBM-supplied defaults. 


Table 34. Checklist for Recovering User Information Using Operational Assistant Backup Tapes 
Task What To Do Where To Read More About It 


___ Task 1 If your system is operational and the 
QUSRSYS library is on the system, print the 
Backup Status and the Backup History by 
typing: DSPBCKSTS OUTPUT (*PRINT). 


___ Task 2 If your system is operational and the 
QUSRSYS library is on the system, print the 
Backup List by typing: DSPBCKUPL 


OUTPUT (*PRINT). 
___ Task 3 If your system is not already in a restricted “Putting Your System in a Restricted| 
state, ensure all users are off the system. State” on page 47) 


Then type ENDSBS SBS(*ALL) 
OPTION(*CNTRLD) DELAY (600)? 


___ Task 4 If necessary, change the QVFYOBJRST 
system value back to its original value by 
using the WRKSYSVAL command. Write the 
old value here: 


“Controlling Restoration of 


Security-Sensitive Objects” on page 52 


___ Task 5 If necessary, change the QALWOBJRST “Controlling Restoration of 
system value back to its original value by Security-Sensitive Objects” on page 52 


using the WRKSYSVAL command. Write the 
old value here: 


___ Task 6 If necessary, change the system value that The System Values subtopic of the 
controls whether the job log wraps when it is System Management topic in the 
full. Use the Work with System Values iSeries Information Center. 


command: WRKSYSVAL QJOBMSGOQEFL. 
Write down the current value here: 

Then change the value to 
*PRTWRAP. 
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Table 34. Checklist for Recovering User Information Using Operational Assistant Backup Tapes (continued) 


Task What To Do Where To Read More About It 
___ Task 7 After changing the system values, sign off by 
using the command SIGNOFF *LIST. Then, 
using a newly created password, sign back 
on as QSECOFR for the new values to take 
effect. 
___ Task 8 If restoring to a system with a different 
processor or memory, ensure the Value for a Different Processor or 
QMCHPOOL, QBASPOOL, and QPFRADJ Memory” on page 55 
system values are correct by using the 
WRKSYSVAL command. 
___ Task 9 Prevent messages that are not related to the 
recovery from interrupting by typing: 
CHGMSGQ MSGQ(QSYSOPR) DLVRY(*NOTIFY) 
SEV (99) 
___ Task 10 Restore user profiles: RSTUSRPRF DEV(TAP@1) |“Restoring User Profiles” on page 222 
USRPRF(*ALL). 
___ Task 11 Restore device configuration: RSTCFG “How to Restore Configuration 
OBJ(*ALL) OBJTYPE(*ALL) DEV(TAPO1) Objects” on page 235 
___ Task 12 Restore the libraries to each ASP that you are |“How to Restore Your Libraries” on 
recovering. If you choose not to restore all of 
your libraries at this time, ensure that you 
restore the QGPL and QUSRSYS libraries 
along with the libraries that you are 
restoring. When recovering the entire system, 
there is no need to restore QGPL and 
QUSRSYS libraries first. 
__ Task 13 Restore the ownership for DLOs in the user |“Task 8—Reclaiming Document Librar 
ASPs that you are restoring. Objects” on page 192| 
___ Task 14 Restore your last complete save of document |“Restoring Documents and Folders” on| 
library objects to each user ASP that you are 
recovering. 
___ Task 15 Restore your last complete save of “Restoring Objects in Directories” o 
directories®. page 268 
___ Task 16 Restore incremental backups of libraries. “How to Restore Libraries That You 
Saved by Using a Backup List” on 
page 307 
___ Task 17 Restore changed objects. “How to Restore Changed Objects That 
You Saved by Using Operational 
Assistant” on page 308 
___ Task 18 If you use Cryptographic Access Provider, “Recovery Considerations for 
install the Cryptographic Access Provider Cryptographic Access Provider” on 
licensed program (5769AC3) using option 11 |page 62 
on the Work with Licensed Programs menu. 
___ Task 19 Restore authority. Type: RSTAUT “Restoring Object Authorities” on| 
___ Task 20 If you have User-Defined File Systems in “Task 7—-Restoring User-Defined File 


User ASPs that do not restore correctly, you 
may need to perform additional recovery 
steps. 


Pool” on page 191 


Systems to the User Auxiliary Stor 


is}) 
Q 
@O 
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Table 34. Checklist for Recovering User Information Using Operational Assistant Backup Tapes (continued) 


Task 


What To Do Where To Read More About It 


___ Task 21 


“Completing Recovery for the iSeries 


Integration for Windows Server 


Product” on page 270 


If you use Windows server on iSeries and 
saved with the Integrated xSeries Server 
(NWSD) varied off, complete recovery for 
the Windows server on iSeries product. 


___ Task 22 If you run Linux and saved Linux by “Recovering Linux in a Partition” on 
varying off the network server description page 271 
(NWSD) for Linux, complete the recovery for 
Linux. 
___ Task 23 If necessary, change the QALWOBJRST “Controlling Restoration of 
system value. Security-Sensitive Objects” on page 52 
___ Task 24 If necessary, change the QVFYOBJRST “Controlling Restoration of 
system value. Security-Sensitive Objects” on page 52 
___ Task 25 If necessary, change the QROBMSGQFL The System Values subtopic of the 
system value back to its original value by System Management topic in the 
using the WRKSYSVAL command. iSeries Information Center. 
___ Task 26 Perform either a: 
SIGNOFF *LIST 
ora 
DSPJOBLOG * *PRINT 
Check the job log to ensure all objects were 
restored. The job log contains information 
about the restore operation. To verify that all 
objects were restored, spool the job log for 
printing along with the job’s remaining 
spooled output, if any. 
Message CPC3703 is sent to the job log for 
each library that was successfully restored. 
Message CPF3773 is sent to tell you how 
many objects were restored. Objects are not 
restored for various reasons. Check for any 
error messages, correct the errors, and then 
restore those objects from the media. 
___ Task 27 You must perform a normal IPL at this “How to Perform™ a Normal IPL” on 
time. page 61 
___ Task 28 If you use Windows server on iSeries and “Completing Recovery for the iSeries 
saved with the Integrated xSeries Server Integration for Windows Server 
(NWSD) varied on, complete recovery for the |Product” on page 270 
Windows server on iSeries product. 
___ Task 29 If IBM Content Manager OnDemand for 
iSeries is installed, complete journaling for 
IBM Content Manager OnDemand for iSeries 
by typing the following commands: 
CALL QRDARS/QRLCSTRJ PARM('RLC') 
CALL QRDARS/QRLCSTRJ PARM('RLR') 
CALL QRDARS/QRLCSTRJ PARM('RLO') 
___ Task 30 Review job logs or output from your restore [How _to Verify That Objects Are 


operations to ensure that all objects were Restored Successfully” on page 56 


restored successfully. 
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Table 34. Checklist for Recovering User Information Using Operational Assistant Backup Tapes (continued) 


Task 


What To Do Where To Read More About It 


1 


Your system must be in a restricted state to restore user profiles. Other steps in the recovery may not 
require a restricted state. However, to ensure the success of your recovery and better performance when 
you are restoring information, a restricted state is recommended. 


For the delay parameter, specify a number of seconds that allows your system time to bring most jobs to a 
normal end. On a large, busy system, you may need a longer delay. 


You may receive one of the following messages: 


CPD377A: Object not restored, /QNTC. 
CPD377A: Object not restored, /QNetWare. 


These objects cannot be restored until their file systems have been mounted during the IPL. The additional 
recovery tasks will guide you through the steps to restore these objects. 

Note: Since the OS/400 Enhanced Integration for Novell NetWare resides on a remote server, you do not 
have to restore your Netware data when you restore your server. Previously, the OS/400 Integration for 
Novell NetWare product ran on a Integrated xSeries Server and you had to restore the Novell product if 
you completely restored your server. 
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Chapter 5. Recovering the Licensed Internal Code 


Licensed Internal Code is the layer of iSeries server architecture just above the 
hardware. You must have the Licensed Internal Code on your machine before you 
can restore the operating system. You must use the control panel on your system 
unit to start the recovery of the Licensed Internal Code. 


The Install Licensed Internal Code (LIC) menu provides several methods for 
loading the Licensed Internal Code to your system. |Table 35| describes the options 
and how they are used: 


Table 35. Options from the Install the Licensed Internal Code (LIC) Menu 


Option Number Description Purpose 
1 Restore Licensed Internal Restores the Licensed Internal Code without removing other 
Code information that is on the system. Option 1 is similar to Function 


Code 23 on earlier versions of the iSeries or AS/400e server. 

Option 1 is normally used in the following situations: 

* You are encountering problems with the operating system, such 
as damaged objects. You sometimes need to restore the 
Licensed Internal Code before restoring the operating system. 

* The software support center recommends it. 

* You have replaced a failed disk unit other than unit 1 in the 
system ASP. 

* You are updating your system to a new release. See the Software 
Installation book for the procedures to install a new release of 
the iSeries server. 


2 Install the Licensed Internal Installs the Licensed Internal Code and removes all data from all 
Code and Initialize system disk units. Option 2 is similar to Function Code 24 on earlier 
versions of the iSeries or AS/400e server. Option 2 is normally 
used in the following situations: 


¢ You are doing a restore operation using the SAVSTG media. 


e« You are restoring to another system to recover from a complete 
system loss. 


* You are recovering with SAVSYS media that is at a previous 
release than what is currently installed on the system. 


If a system is configured to use Operations Console, and that 

system undergoes a backup and recovery cycle, you will have to 

perform the following steps: 

1. Perform an initial program load (IPL) in Manual mode. 

2. Use dedicated service tools (DST) to reconfigure the system so 
that it will detect the PC console when you perform an IPL in 
Normal mode. 


Detailed instructions on setting up Operations Console are in the 
Connecting to iSeries topic in the iSeries Information Center at 
http: / /www.ibm.com/eserver /iseries /infocenter. 
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Table 35. Options from the Install the Licensed Internal Code (LIC) Menu (continued) 


Option Number Description 


Purpose 


3 Install Licensed Internal Code 
and Recover Configuration 


Installs the Licensed Internal Code and prompts you to begin the 
procedure to recover information about how the disks were 
configured on your system (including ASP assignments and 
protection). Option 3 is similar to Function Code 24 on earlier 
version of the iSeries or AS/400e server. Option 3 is normally 
used in the following situations: 


* You have replaced the load source unit. 


* The software support center recommends it. 


4 Install Licensed Internal Code 
and Restore Disk Unit Data 


Installs the Licensed Internal Code and restores data to a 
replacement disk unit. This option is used only by a service 
representative after data was successfully saved (pumped) from a 
failed load source disk unit. 


5 Install Licensed Internal Code 
and Upgrade Load Source 


This option is used in certain cases when you are changing to a 
PowerPC based system. See the AS/400 Road Map for Changing to 
PowerPC Technology for more information. 


The recovery checklists in|Chapter 4) specify which procedures in this chapter are 


required for your situation. 


Attention! 


Make sure you use the correct procedure for your situation. Some of the 
procedures in this chapter will remove all data from your system. 


How to Prepare for Loading the Licensed Internal Code 


The tasks for starting to load the Licensed Internal Code include the following: 


* Finding the right media and documentation. 


* Stopping your system, if it is running. 


* Performing an IPL from an alternate device, either tape or optical media. 


Check off each step in these tasks as you complete it. 


Task 1—Getting Ready to Load the Licensed Internal Code 
Find These Things Before You Begin: 
* Your most recent SAVSYS media. One of the following creates a SAVSYS media 


image: 


— Running the Save System (SAVSYS) command. 


— Using option 21 from the Save menu. 


— Using option 22 from the Save menu. 


— Using option 11 from the Run Backup menu. 
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;_ Attention! 
DO NOT use a media volume that you created through DST by using 
option 5=Save Licensed Internal Code from the IPL or Install the System 
menu unless you have been instructed to do so by Software Services. A 
media volume that is created through this process does not contain the 
Licensed Internal Code PTF Inventory information or the OS/400 
Operating System. If you perform the recovery process using this media 
volume, you will have to re-install the Licensed Internal Code from either a 
SAVSYS media volume or from your distribution media before you can 
load any PTFs onto the system. 


* If you enabled your device as an alternate installation device, you will need the 
Licensed Internal Code CD-ROM. (An alternate installation device is an alternate 
IPL device that is connected to a bus other than the system bus (bus 1).) Refer to 
[Chapter 1, "Using an Altemate Installation Device” on page 373|or mor 
information. 


* If you do not have current SAVSYS media or they are damaged, you need the 
following: 


— The distribution media (optical media or tape) that is supplied by IBM. 


— All the optical media for program temporary fixes you have applied. Use the 
distribution media only if you do not have SAVSYS media. If you use the 
distribution media to restore the Licensed Internal Code, you will lose some 
of your system information, such as the program temporary fixes you have 
applied. 

* The list of all the program temporary fixes (PTFs) applied to your system at the 
time you saved the entire system. This list should be attached to your backup 
log or found with your SAVSYS media. 


* The keystick for the system if it is not already inserted in the control panel. 


* The manual for the tape or optical device that is your alternate IPL device. It 
describes other SRC codes you might see. 


Do These Things Before You Begin: 

* Clean the read and write heads of the tape unit if you are using a tape device. 

* If your source system (the system that was saved and needs recovery) is 
operational, print a list of all the program temporary fixes (PTFs) currently on 
the system. Type the following and press the Enter key: 

DSPPTF LICPGM(*ALL) OUTPUT (*PRINT) 

* If you are using Operations Console, LAN or direct connect, disconnect from 
your server and close Operations Console. Restart Operations Console and 
reconnect by using the user ID of 11111111 and password of 11111111 to sign on 
to your server. 


Task 2—Powering Down the System 


Attention: If you are loading the Licensed Internal Code in a secondary partition, 
you do not need to power down the system. 


If your system is already powered off or if you are recovering to a system at an 
IBM Business Recovery Services Center, skip this task and begin with 
Ba—Preparing the System to Perform an IPL from an Alternate Device” on page 126 


It is not necessary to power down a system that has no activity on the system. 
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1. Sign on the system as QSECOFR. 
2. Change the QSYSOPR message queue: 


CHGMSGQ MSGQ(QSYSOPR) DLVRY (*BREAK) 
SEV (60 


3. Bring your system to a restricted state: 


ENDSBS SBS(*ALL) OPTION(*CNTRLD) 
DELAY (600) 


Note: Specify a number of seconds for the delay parameter that is long enough 
for your system to bring most jobs to a normal end. On a large, busy 
system, you may need more time. 


The system displays a message that subsystem ending is in progress. The 
system displays another message when all subsystems have ended and the 
system is in a restricted state. After the subsystems have ended, continue with 
the next step. 


4. Change the QSYSOPR message queue: 


CHGMSGQ MSGQ(QSYSOPR) DLVRY (*BREAK) 
SEV (99) 


Note: Communications messages with a severity of 99 that require a reply can 
interrupt your restore operation. You can either identify these messages 
and add them to the system reply list, or you can change the delivery of 
the QSYSOPR message queue to *NOTIFY. This prevents the 
communications messages from interrupting the interactive restore 
operation. 


5. Power down the system: 
PWRDWNSYS OPTION (*IMMED) 


Attention Logical Partitioning users! 
Before issuing this command, be certain that all secondary partitions have 
been powered off. 


Note: When the Power On light goes off, continue with the next task. 


Task 3a—Preparing the System to Perform an IPL from an 
Alternate Device 


To perform an initial program load (IPL) from tape, optical media, or CD-ROM, 
you must use the control panel on the system unit. The steps vary slightly based 
on the type of system unit that you have. Click on Basic system operations under 
the Systems management topic in the iSeries Information Center if you are unsure 
of the procedures for your system. You can find the Information Center at the 
following Web site: 


http://www. ibm.com/eserver/iseries/infocenter/ 

Note: This task only applies to the primary partition. If you are installing to a 
secondary partition, use the Work with system partitions option in SST or 
DST on the primary partition. See the Information Center for more 
information about logical partitions. 


Do the following: 
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1. If your system unit has a lock on the control panel, use the key or keystick to 
unlock the control panel. 


2. Place the system in Manual mode. 

3. Press the Function Select switch (or buttons) to display 02 (IPL) in the Function 
display. 

4. Press the Enter button on the control panel. 


5. Press the Function Select switch (or buttons) to display D (IPL from tape, optical 
media, or CD-ROM) in the Data display. 


6. Press the Enter button on the control panel. 


7. Ensure that any switches for the alternate IPL device and for all disk units are 
in the On position. 


Task 3b-Preparing a Logical Partition to Perform an IPL from 
an Alternate Device 


To perform an IPL from tape, optical media, or CD-ROM, you must use the Work 
with Partition Status display from the primary partition. Perform the following 
steps on the primary partition: 


1. Type STRSST on a command line, and press Enter. 


2. On the System Service Tools (SST) display, select option 5 to work with system 
partitions, and press Enter. 

3. On the Work with System Partitions display, select option 2 to work with 
system partition status, and press Enter. 

4. On the Work with System Partition Status display, select manual mode by 
typing a 10 in the option field next to the partition that you are performing the 
alternate IPL on. Press Enter. 


5. Select source D by typing a D in the option field next to the partition on which 
you are performing the alternate IPL . Press Enter. 


Task 4—Loading the Licensed Internal Code from Media 


Note: If you are working in a secondary partition, keep the following 

considerations in mind for this task: 

* You may skip step 3 below (turn on system power), since you have not 
powered off. 

* In step 4, you are using the virtual control panel instead of the system 
unit control panel. 

* Instructions dealing with alternate installation do not apply to secondary 
partitions. (You can install from any tape device or optical device in the 
partition.) 


1. Find the Licensed Internal Code tape or optical media. It is the first volume of 
the most current set of SAVSYS media or the first volume of the distribution 
optical media. 
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Attention! 


* DO NOT use save media that was created through DST by using 
option 5=Save Licensed Internal Code from the IPL or Install the 
System menu unless you have been instructed to do so by Software 
Services. The save media that you create through this process does not 
contain the Licensed Internal Code PTF Inventory information or the 
OS/400 Operating System. If you perform the recovery process using 
this save media, you will have to re-install the Licensed Internal Code 
from either a SAVSYS media or from your distribution media before 
you can load any PTFs onto the system. 


* Use the distribution media only if no SAVSYS media volume exists. If 
you use the distribution media, some system information will be lost. 
This includes, but is not limited to, PTFs and PTF packages. If you use 
the distribution media, you must reinstall all cumulative PTF packages 
and individual PTFs applied after the initial installation of your 
system. 


2. Place the media volume in the device that you use for the IPL, or place the 
optical media in the optical disk unit. When you start the IPL, the system 
searches the alternate IPL devices for the correct media. For more information 
on loading the tape or optical media, see the setup manual for the device. 


Notes: 


a. If you cannot load your alternate IPL device when the power is off, 
continue with the next step. The system prompts you later with an SRC 
code for the tape device or optical device. 


b. If you use a tape device that you enabled as an alternate installation 
device, you must load both the Licensed Internal Code CD-ROM and your 
tape media. (An alternate installation device is an alternate IPL device that 
is connected to a bus other than the system bus (bus 1).) Refer to 
[chapter 18, “Using an Altemate Installation Device” on page 379 for mor 
information. 

3. Turn on the power to the system. 


Using Logical Partitions? 
On the primary partition, go to the Work with System Partition Status 
display. Turn the power on by typing a 1 in the option field next to the 
partition on which you are performing the alternate IPL . 


4. If you could not load your media volume in step |2| load the first media 
volume into the device that you use for IPL. Make the device ready and then 
continue with the next step. 


Note: If you did not power down your system after ending the subsystems, 
do the following: 


a. Press the Function Select switch (or buttons) to display 03 (continue 
the IPL) in the Function display on the control panel. 


b. Press the Enter button on the control panel. 
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,_ Using Logical Partitions? 
If you are performing an alternate IPL for a logical partition, 
perform the following steps: 


1) On the primary partition, go to the Work with System 
Partition Status display. Select IPL restart by typing a 3 in 
the option field next to the partition on which you are 
performing the alternate IPL . 


2) Press Enter. 


3) You will be shown the Confirm Alternate IPL display. The 
system denotes the selected alternate IPL device with a 
percent (%) sign. If this is the correct alternate IPL device, 
press Enter to continue with the IPL and continue with 
step 
If there is no alternate IPL device defined, or if you want to 
select a different alternate IPL device, press F11 (Select 
alternate IPL resource). On the Select Alternate IPL 
Resource display, type a 1 in the option field next to the 
Storage IOP of the device that you want to select. Press the 
Enter key. You will be shown the Confirm Alternate IPL 
Resource display. Press Enter to confirm your choice. Press 
F12 to return to the Confirm Alternate IPL display. Press 
Enter to continue with the IPL. 


5. Ensure that the tape device or optical device is online or ready. No action is 


required for devices that perform this step automatically (such as the tape 
cartridge unit). 

Ensure that the console display is turned on. After a delay, you should see the 
Install Licensed Internal Code menu. The length of the delay varies, 
depending on your system configuration and the speed of your alternate IPL 
device. The delay is usually between 5 minutes and 30 minutes. When you see 


this menu, continue with step |7 on page 130 


If the system attention light appears and one of the SRC codes that are shown 
in[Table 36|is displayed in the Data display, complete the instructions for that 
SRC code. 


Note: If you are using logical partitions, the SRC codes will be shown from 
the primary partition on the Work with Partition Status or the Monitor 
Partition Status displays. 


Table 36. SRC Codes When Loading the Licensed Internal Code 


SRC Code 


Why It Appears 


What You Do 


A1xx 1933 
A12x 1933 
(x’ is any 
character) 


The device for the alternate IPL is not 
ready. 


Make sure that you loaded the 
correct media volume. Make the 
device unit ready. Wait for the 
System Attention light to go off. 
Then continue with the next step. 
If the Sytem Attention light stays 
on for more than 5 minutes, check 
to see if you have the correct tape 
loaded in the device for the 
alternate IPL and make the device 
ready. Then continue with the next 
step. 
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Table 36. SRC Codes When Loading the Licensed Internal Code (continued) 


SRC Code 


Why It Appears 


What You Do 


Blxx 1803 
Blxx 1806 
Blxx 1938 


The device for the alternate IPL was not 
found or was not ready. 


Make sure that you powered on 
the device, that you loaded the 
correct media volume, and the 
media volume is ready. Then 
continue with the next step. 


Blxx 1934 


The wrong media volume is loaded. Or 
the high-speed feature is enabled on the 
2440 Tape Unit. 


Load the correct media volume 
and make the device ready. Then 
continue with the next step or 
disable the high-speed feature on 
the 2440 Tape Unit. 


B608 1105 


This SRC occurs when you exit from the 
automatic installation because an alternate 
installation device attached to the system 
is enabled but is otherwise not ready. The 
device may not be ready because the 
media volume is not loaded or the device 
may not be enabled as an alternate 
installation device. Or, there may be a 
problem with the device. 


Power down the system. If 
necessary, fix the device. Power on 
the system. Verify that the 
alternate installation device is 
enabled. Load the media volume 
in the alternate installation device 
and start the installation procedure 
again. 


2507 0001 
2642 0001 
2643 0001 


A media volume is not loaded in the 
device for the alternate IPL. 


Make sure the correct media 
volume is loaded in the correct 
device. Then continue with the 
next step. 


2644 3136 


The device is assigned to another system. 


Go to the other system and vary 
off the device. Make sure that you 
loaded the correct media volume. 
Then continue with the next step. 


Any other 
SRC 


The system encountered a problem 
loading the Licensed Internal Code. 


If the System Attention light is lit and no SRC code appears on the control 


panel, 


do the following: 


a. Press the Function Select switch (or buttons) to display 03 (continue the 
IPL) in the Function display on the control panel. 


b. Press the Enter button on the control panel. 


Then continue with the next step. 


7. You are shown the Install Licensed Internal Code (LIC) display. 


Install Licensed Internal Code 


Select one of the following: 


I. 


Install Licensed Internal Code 


2. Work with Dedicated Service Tools (DST) 
3. Define alternate installation device 


If you_have an alternate installation device attached to the system, perform 
steps [3] through [10] If you do not have an alternate installation device attached 
to the system, type a 1 and press the Enter key. 
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;_ Stop! 
You are now ready to recover your Licensed Internal Code. Consult your 
recovery checklist before continuing. The checklist tells you the correct 
option to select from the Install Licensed Internal Code (LIC) display. 


8. If you have an alternate installation device attached to the system, type a 3 to 
verify its address and determine whether it is enabled or disabled. 


9. The Select Alternate Installation Device Bus screen appears. 


Ve 
Select Alternate Installation Device Bus *) 
System: YOURSYS 


Type Option, press Enter. 
1=Select 


Option Bus Number Selected 


* 


TONAWPYrOANA TA HWP 


ceil ect device F3=Exit 12=Cancel 


The Selected column shows the bus where the alternate load source is 
currently defined. You can use the F2 key to deselect the current bus and then 
use option 1 to select another. All buses that exist on the system are displayed. 


After pressing the Enter key, there will be a brief delay (up to 10 minutes) 
while the bus is initialized. Following this delay, the Select Alternate 
Installation Device screen appears. 


Select Alternate Installation Device ) 
System: YOURSYS 
Type option, press Enter. 
1=Select 5=Details 
Resource Serial 
Option Name Type Model Number Selected 
7 TAPO1 6380 001 00-1017187 
_ TAPO8 3287 030 32-234333 
es TAPO2 6380 001 00-2017187 
i TAPO5 3287 030 72-234333 * 
2 TAPO9 6380 001 00-1015187 
= TAP16 3287 030 22-234633 
F2=Deselect device F3=Exit F5=Refresh F12=Cancel y 


Type a 1 in the Option field to select the device you wish to use, and press the 
Enter key. 
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Note: When installing from an alternate installation device, be sure that only 
one device contains valid install media. This will prevent the wrong 
version of the Licensed Internal Code from being installed. 


10. The Install Licensed Internal Code display appears. Type a 1 and press the 
Enter key. 


Stop! 


You are now ready to recover your Licensed Internal Code. Consult your 
recovery checklist before continuing. The checklist tells you the correct option 
to select from the Install Licensed Internal Code (LIC) display. 


How to Load the Licensed Internal Code 


-— If you receive an error screen: 


See|Appendix A, “Licensed Internal Code Installation Error Screens” on 


lpage 489] for information on the possible error screens that can be displayed 
during LIC installation. 


If you are using an alternate installation device and you receive an error 
screen, it may be due to one of the following conditions: 


* You are trying to install from CD-ROM when an alternate installation 
device is enabled. 


* You are trying to use an alternate installation device which is not enabled. 


Review [Setting up an Alternate Installation Device” on page 375] and 
“Disabling an Alternate Installation Device” on page 378] and perform the 


appropriate procedure. 


Note: You may find that the address information is not available, or that the 
system configuration has changed so that the address information is 
not correct. If this occurs, you must determine the address information 
by a physical inspection of your system configuration. This inspection 
can be difficult and may vary depending on your system model and 
the specific configuration of your IO buses. For this reason, IBM 
recommends that you call your next level of support for assistance in 
determining the addresses you need for the alternate installation 
device. A service agreement may be required for this type of assistance. 


To complete the procedure for loading the Licensed Internal Code to your system 
during a recovery, do the following: 


1. You should see the Install Licensed Internal Code (LIC) display: 


132 0S/400 Backup and Recovery V5R2 


Va 


Install Licensed Internal Code (LIC) 


Disk selected to write the Licensed Internal Code to: 


Serial Number Type Model 1/0 Bus Controller Device 
XX=XXXXXXX XXXX XXX Xx Xx Xx 


Select one of the following: 


Restore Licensed Internal Code 

Install Licensed Internal Code and Initialize system 
Install Licensed Internal Code and Recover Configuration 
Install Licensed Internal Code and Restore Disk Unit Data 
Install Licensed Internal Code and Upgrade Load Source 


aorWNr 


Select the correct option and press the Enter key. 


; Attention! 
Be sure you consult the correct recovery checklist before selecting an 
option from the Install Licensed Internal Code (LIC) display. Some options 
remove all data from your system. 


If there is an alternate installation device defined and enabled, the Confirm 
Alternate Installation Device display appears. 


* To recover from the alternate installation device, press the Enter key. 


* To recover from CD-ROM, press F12 to cancel. The Install Licensed Internal 
Code display appears. Select option 3 (Define alternate installation device). 
Perform steps |through[10]and disable the alternate installation device. 


One of the following Install LIC and Initialize System—Confirmation screens is 
shown if you chose option 2, 3, 4, or 5 from the LIC installation display. You 
must press F10 to continue the installation; pressing the enter key just 
re-displays the confirmation screen. 


Fe 


Install LIC and Initialize System - Confirmation 


Warning: 


All data on this system will be destroyed and the Licensed 
Internal Code will be written to the selected disk if you 
choose to continue the initialize and install. 


Return to the install selection screen and choose one of the 
other options if you want to perform some type of recovery 
after the install of the Licensed Internal Code is complete. 


Press F10 to continue the install. 
Press F1l2 (Cancel) to return to the previous screen. 
Press F3 (Exit) to return to the install selection screen. 
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Install LIC and Recover Configuration - Confirmation 


Warning: 
All data on the selected disk will be destroyed and the Licensed 
Internal Code will be written to this disk if you choose to 
continue the install. When the install is complete, an IPL 
will be done and you will be prompted to continue the recovery 
of the DASD configuration. 


Press F10 to continue the install. 
Press Fl2 (Cancel) to return to the previous screen. 
Press F3 (Exit) to return to the install selection screen. 


a >) 


Install LIC and Restore Disk Unit Data - Confirmation 


Warning: 
All data on the selected disk will be destroyed and the Licensed 
Internal Code will be written to this disk if you choose to 
continue the install. When the install is complete, an IPL 
will be done and you will be prompted to restore the disk unit 
data that you previously saved. 


Press F10 to continue the install. 
Press Fl2 (Cancel) to return to the previous screen. 
Press F3 (Exit) to return to the install selection screen. 


Install LIC and Upgrade Load Source - Confirmation 


Warning: 
All data on the selected disk will be destroyed and the Licensed 
Internal Code will be written to this disk if you choose to 
continue the install. When the install is complete, an IPL 
will be done and you will be prompted to complete the upgrade. 


Press F1@ to continue the install. 
Press F1l2 (Cancel) to return to the previous screen. 
Press F3 (Exit) to return to the install selection screen. 


S oe 


The Initialize the Disk-Status screen is shown if you chose option 2, 3, 4, or 5 
on the install selection menu, and then pressed F10 on the confirmation screen. 
The actual time to initialize the disk can be considerably less than the estimated 
time, depending on the current state of the disk. 


134 08/400 Backup and Recovery V5R2 


Initialize the Disk - Status 


The load source disk is being initialized. 


Estimated time to initialize in minutes : 


Elapsed time in minutes ........: 


4. You are shown the Install Licensed Internal Code-Status display. You do not 
need to respond to this display. The system shows this display for 
approximately 30 minutes. 


( : eS 
Licensed Internal Code Installation Status 
Installation of the Licensed Internal Code in progress. 
teas ae ea = a ee + 
Percent complete — | XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX | 
poe e a= a eee eee eae eee a ea eee eae + 
) 20 40 60 100 
Elapsed time in minutes ........: X.X 
Please wait. 
e yy 


5. If an error occurs, you may see a display that requires a response. 


Stop! 
| You have finished loading your Licensed Internal Code. 


If you are using logical partitions, and you have installed the Licensed Internal 
Code to the primary partition, you will receive the following message on the Disk 
Configuration Error Report display: 


Disk Configuration Error Report 


Type option, press Enter 
5=Display Detailed Report 


OPT Warning 
Unit has incorrect logical partition configuration 


This message indicates that the partitioning_configuration should be recovered. 
Perform the steps that are listed below in}|How to Recover Your Logical Partition| 
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Note: There may be multiple logical partition configuration error messages for 
different disk units. The steps that are listed will resolve all of these 
messages. 


How to Recover Your Logical Partition Configuration 


If you are using logical partitions, use the following steps to recover the primary 
partition. 


1. Select the Use Dedicated Service Tools option. 

2. Sign on to Dedicated Service Tools. The system displays the Use Dedicated 
Service Tools menu. 

3. From the Use Dedicated Service Tools (DST) menu, select option 11, Work with 
system partitions. 


S 


Use Dedicated Service Tools 


Select one of the following: 

. Perform an IPL 

. Install the operating system 

. Work with licensed internal code 

. Work with disk units 

. Work with DST environment 

. Select DST console model 

. Start a service tool 

. Perform automatic installation of the operating system 
. Work with save storage and restore storage 
. Work with remote DST support 

. Work with system partitions 


FOWOONAAHBWNHEH 


PR 


You are shown the Work with System Partitions display. 

4. From the Work with System Partitions display, select option 4, Recover 
configuration data. 

5. Choose option 1, Recover primary partition configuration data. 

6. The system will look through all non-configured disk units for partition 
configuration data. The disk unit with the newest configuration data for the 
current system will be listed. 


Select Disk Unit for Configuration Data Recovery 
System: XXXXXXXX 
Type option, press Enter: 
1=Select 


1/0 Resource --Last Updated--- System 
Opt Description Type-Model Date Time Serial Number 


7. Review the information for the displayed disk unit. Ensure that the Last 
Updated and System Serial Number fields contain reasonable information. Type 
a 1 to select the disk, and press the Enter key. 

8. Press Enter to accept the recovery. 
The system automatically copies the configuration data to the primary 
partition’s load source, and performs an IPL to DST. 


If you are restoring one partition with a previously mirrored load source, you may 


continue to receive an error message after the IPL to DST. The message text is 
"Unit has incorrect logical partition configuration”. 
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If you do not receive this message, stop here. You have completed recovering your 
logical partition configuration. Consult your recovery checklist to determine the 
next step in your recovery process. 


If you receive this message, you must clear this obsolete configuration by 
performing the following steps: 


1. After receiving the error message, use option 5 to determine which disk unit 
has the obsolete partition configuration. 


2. Exit the configuration error by pressing F3 to go to the DST menu. 


3. From the Use Dedicated Service Tools menu, select option 11, Work with 
system partitions. 


4. Select option 4 (Recover configuration data). 
5. Select option 3 (Clear non-configured disk unit configuration data). 


6. Select the disk unit that was originally reported for the partition configuration 
error. 


7. Press F3 to return to the DST menu. 

8. Select option 7, Start a service tool. 

9. At the Start a Service Tool display, select option 7, Operator panel functions. 
10. At the Operator Panel Functions display, press F8 to restart. 


;— Stop! 
You have completed recovering your logical partition configuration. Select 
from the following options: 


¢ If you are loading the Licensed Internal Code as part of the steps of 


Chapter 14, “How to Restore the System from the Save Storage Media” on 


page 311|you will see the Disk Configuration Attention Report displayed. 
g y} 8 P 
Chapter 14 


Select F3=Exit to Dedicated Service Tools (DST). Return to 
and continue the Restore Storage procedures. 


* If you selected option 2 from the Install Licensed Internal Code display, 
continue with |“How to Set Up Your Disk Configuration After Installing the 
Licensed Internal Code and Initializing the System” 


* If you selected option 3 from the Install Licensed Internal Code display, 
continue with |“How to Recover Your Disk Configuration” on page 143 
* If you selected option 4 from the Install Licensed Internal Code display, 


continue with the recovery steps to restore disk unit data to the new load 
source disk unit. 


* If you selected option 5 from the Install Licensed Internal Code display, 
continue with the recovery steps to upgrade the load source disk unit from 
an IMPI-based system to a PowerPC-based system. 


* If you do not need to restore the operating 
Start Your System After Restoring Licensed Internal Code” on page 146 


How to Set Up Your Disk Configuration After Installing the Licensed 
Internal Code and Initializing the System 


When you install the Licensed Internal Code by using option 2 from the Install 
Licensed Internal Code (LIC) menu, the system does the following: 
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* The system clears disk unit 1. Disk unit 1 contains information about how all the 
other disk units on your system are configured. If you are using logical 
partitioning, disk unit 1 also contains your partitioning configuration data. 

* The system prepares to delete all data in the system ASP. The system ASP is not 


actually cleared until you perform the IPL after installing the Licensed Internal 
Code. 


1. When you complete installing the Licensed Internal Code, you are shown the 
Disk Configuration Attention Report display on the A or B mode IPL: 


Disk Configuration Attention Report 


Type option, press Enter 
5=Display Detailed Report 


OPT Warning 
New disk configuration 


2. If you type a 5 in the option column (OPT), you are shown the following 
display: 


The current configuration indicates a single unit system. You 
can choose to accept it or do one of the following: 


Following are the possible causes and recovery procedures: 
e You can define a new configuration by adding units. 


¢ Press F3 to exit to Dedicated Service Tools (DST) and if 
necessary, take the right option to get to 

"Use Dedicated Service Tools (DST)' display. 

On the 'Use Dedicated Service Tools (DST)' display, 

- Select option 4, Work with disk units. 

- Select option 1, Work with disk configuration. 

- Select option 3, Work with ASP configuration. 

- Select option 3, Add units to ASPs. 


e If you are performing ‘Recover mirror load source' 
utility, press F3 to exit to Dedicated Service Tools (DST). 
If necessary, take the right option to get to 'Use 
Dedicated Service Tools (DST)' display. 

On the 'Use Dedicated Service Tools (DST)' display, 

- Select option 4, Work with disk units. 

- Select option 2, Work with disk unit recovery. 

- Select option 16, Recover mirrored load source. 


Press Enter to accept the current configuration and continue. 


3. Press F10 or enter to accept the new disk configuration and continue. 
4. Perform the following steps: 


a. Create all logical partitions. Refer to the iSeries Information Center at 
http:/ /www.ibm.com/eserver/iseries/infocenterfor information on creating 
logical partitions. 


Initialize all of the non-load source disk units on your system. 
Define which ASP each disk unit is configured in. 
d. Determine which ASPs to start mirrored protection on. 


See |“Configuring Disks on a New System—Checklist 1” on page 384|for a 


checklist on adding disk units to the system ASP, adding disk units to the user 
ASPs, starting mirrored protection on ASPs, and starting device parity 
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protection. When you have completed the checklist press F12 to cancel the DST 
menu. You are shown the IPL or Install the System menu. 


;— Stop! 
You have now completed your disk configuration. Continue with the next 
step on your recovery checklist, which is restoring the operating system. 


How to Recover Your Disk Configuration Using iSeries Navigator at 


DST 


When you install the Licensed Internal Code by using option 2 from the Install 
Licensed Internal Code (LIC) menu, the system does the following: 


* The system clears disk unit 1. Disk unit 1 contains information about how all the 
other disk units on your system are configured. If you are using logical 
partitioning, disk unit 1 also contains your partitioning configuration data. 


* The system prepares to delete all data in the system ASP. The system ASP is not 
actually cleared until you perform the IPL after installing the Licensed Internal 
Code. 


These steps allow you to use the dedicated service tools (DST) debug mode to 
access disk management functions in iSeries Navigator where you can configure 
disk units in system, basic, and independent auxiliary storage pools (ASPs) while 
your server is still in DST mode. When you are finished configuring disk units you 
can complete the step-mode IPL. 


Note: You must have configured the Service Tools Network Interface in order to 
do these steps. 
1. You may have received a Disk Configuration Attention Report like the one 
below after you loaded the Licensed Internal Code. If so, press F10 to accept 
the problems and continue. 


DISK CONFIGURATION ATTENTION REPORT 


x 


TYPE OPTION, PRESS ENTER. 
5=DISPLAY DETAILED REPORT 


PRESS F10 TO ACCEPT ALL THE FOLLOWING PROBLEMS AND CONTINUE. 
THE SYSTEM WILL ATTEMPT TO CORRECT THEM. 


OPT PROBLEM 
NEW DISK CONFIGURATION 


2. From the IPL or Install the System menu, select option 3 (Use Dedicated 
Service Tools (DST). 


IPL or Install the System 


Select one of the following: 

. Perform an IPL 

. Install the operating system 

. Use Dedicated Service Tools (DST) 

. Perform automatic installation of the operating system 
. Save Licensed Internal Code 


OFPwWNF 


ye 
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3. On the Dedicated Service Tools (DST) Sign On display, sign on as QSECOFR / 
QSECOFR. 


Dedicated Service Tools (DST) Sign On 
Type choices, press Enter. 


SCnVACEELOOS AUS Gita. ecatou etek votre en vere es QSECOFR 


4. Change the password for the QSECOFR user profile on the resulting screen, as 
the password is expired after the first use. 


f Change Service Tools User Password ) 


Service tools user profile name... . . : QSECOFR 
Password last changed. ......... : 02/05/01 


Type choices, press Enter. 
Current. password: 2:3 tu a so as eG 


New! password) ci: fo 4s sa we wae ee 


New password (to verify) ........ e 


5. On the Use Dedicated Service Tools (DST) menu, select option 6, Select DST 
console mode. 


i. Use Dedicated Service Tools (DST) ) 


Select one of the following: 

. Perform an IPL 

. Install the operating system 

. Work with Licensed Internal Code 

. Work with disk units 

. Work with DST environment 

. Select DST console mode 

. Start a service tool 

. Perform automatic installation of the operating system 
. Work with save storage and restore storage 


. Work with remote service support 
SS oy 


= 
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6. On the Select DST Console Mode display, select option 2 (Start DST debug 
mode on IPL). 


( Select DST Console Mode ) 


Attention: Incorrect use of DST debug mode can cause damage 
to data in this system. Contact your service representative 
for assistance. 


Select one of the following: 


1. Exit Dedicated Service Tools (DST) on IPL 


2. Start DST debug mode on IPL 
& 4 


7. On the IPL or Install the System menu, choose option 1 (Perform an IPL). 
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8. On the Add All Disk Units to the System display, select option 1 (Keep the 


9. 


10. 


11. 


IPL or Install the System 


Select one of the following: 

. Perform an IPL 

. Install the operating system 

. Use Dedicated Service Tools (DST) 


OoFrwWN Fr 


. Save Licensed Internal Code 


. Perform automatic installation of the operating system 


oe 


current disk configuration). 


Add All Disk Units to the System 


Select one of the following: 

1. Keep the current disk configuration 

2. Perform disk configuration using DST 

3. Add all units to the system auxiliary storage pool (ASP) 
4, Add all units to the system ASP and balance data 


- 


On the Install Required for Operating System display, press ENTER to 
continue. 


Install Required for Operating System 


The system ASP has been cleared, which requires an instal] 
of the operating system. 


To instal the operating system , do the following: 

- Load the install media in the device used to install the 
operating system and make the device ready. 

- Press Enter when the device is ready to install the 
operating system. 


-OR- 


Press F1l to display the Dedicated Service Tools sign on or 
main menu and not install the operating system. 


On the Select Type of IPL display, select option 2 (Step-mode IPL). 


Select Type of IPL 


Select one of the following: 
1. Normal IPL 
2. Step-mode IPL 


Step through the IPL by pressing ENTER. The last IPL step before you 


configure disk units is Storage Management Recovery. Press enter on the 


Storage Management Recovery screen shown below. 
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12. 


13: 
14. 


15. 
16. 
17. 
18. 


19: 


20. 


Licensed Internal Code IPL in Progress 


IPL: 
MDVD Geen fe, tev eo ae ea ces es Ga Sa ev Ieee eh sess eee Ae Cended 
Start date and time. ........ . ~: 00/00/00 00:00:00 
Previous system end. ........ ..: Abnormal 
IPL step. ..........4+-.2.+.+... : Storage Management Recovery 


Stop at the resulting IPL step Start LIC Log screen. 
ie > 


Licensed Internal Code IPL in Progress 
TP les 
V¥POss aos oo a oy aoe a wee Yom 6 3 3 Attended 
Start datevand times 35 8. «oss : 00/00/00 00:00:00 
Previous system end......... . .: Abnormal 
TRIASGC Daromtcurone utorrent ee ea wart ere nares Ota tal Cele 
so ey 


Open iSeries Navigator to begin disk unit configuration. 

In the Environmental tasks panel, click Open iSeries Navigator service tools 
window. 

Enter the system name or IP address on the resulting window. 

Expand the server you want to restore. 

Expand Disk Units. 

Right-click All Disk Units and select Add Disk Unit. The wizard will guide 
you through the process of adding disk units to disk pools and starting disk 


protection. Refer to a printed copy of your disk configuration to create all the 
necessary disk pools. 


When your disk unit configuration is complete, continue through the step 
mode IPL. Press ENTER on all of the following IPL steps through Start the 
Operating System. 

After the IPL steps complete, the Install the Operating System menu appears: 
(- > 


Install the Operating System 
Type options, press Enter. 
Install 
Option... =. 1=Take defaults (No other 
options are displayed) 
2=Change install options 
Date 
NG Teese cucu nes _ 00-99 
Monthy 0 01-12 
Day, So a ses = 01-31 
Time: 
HOUT! "P ectes = 00-23 
MiImuUte =. S42 3 00-59 
Second... . __ 00-59 
Ne ey 
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;_ Stop! 
You have now completed recovering your disk unit configuration. Continue 


with the next step on your recovery checklist, which is restoring the operating 
system. 


How to Recover Your Disk Configuration 


When you install the Licensed Internal Code by using option 3 from the Install 
Licensed Internal Code (LIC) menu, the system does the following: 


¢ Clears disk unit 1. Disk unit 1 contains information about how all the other disk 
units on your system are configured. 


* Prepares to delete all data in the system ASP. The system ASP is not actually 
cleared until you perform the IPL after installing the Licensed Internal Code. 


Every disk unit on your system contains information about how it is configured. 
Dedicated services tools (DST) provides an option to recover the disk configuration 
on your system by using this information. The system reads every disk, assigns it 
to the correct auxiliary storage pool (ASP), and rebuilds the disk configuration 
information on unit 1. 


In many cases, you can recover your disk configuration and avoid having to reload 
all your user ASPs. To recover your disk configuration, do the following: 


1. When you complete installing the Licensed Internal Code, you are shown the 
Disk Configuration Error Report display on the A or B mode IPL: 


Disk Configuration Error Report 


Type option, press Enter 
5=Display Detailed Report 


OPT Error 
Missing disk configuration 


2. If you type a 5 in the option column (OPT), you are shown Missing Disk 
Configuration display: 
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Missing Disk Configuration 


The system disk configuration has been lost. The IPL 
cannot be continued. 


The following are the recommended recovery procedures: 
o If the original system has more than one disk unit 
configured and you want to keep the configuration 
currently on the system, use Recover configuration 
under Work with Disk Units. 


Press F3 to exit to Dedicated Service Tools (DST) and 
if necessary, take the right option to get to the 'Use 
Dedicated Service Tools' (DST) display. On the 'Use 
Dedicated Service Tools' (DST) display: 

- Select option 4, Work with disk units. 

- Select option 2, Work with disk unit recovery. 

- Select option 5, Recover configuration. 

o If the original system had only one disk unit configured 
or you do not want to save the data currently on the 
system, re-install the Licensed Internal Code, then 
re-create the configuration, restore your data. 


Game to use Dedicated Service Tools (DST) F12=Cancel , 


From either display, press F3 (Exit to Use Dedicated Service Tools (DST)). The 
Use Dedicated Service Tools Sign On display is shown: 


Dedicated Service Tools (DST) Sign On 
Type choice, press Enter. 


DSTBUSCAcepeatcarse esse cel ten ane 
DST ‘password 2.6 2 3 w% « 


3. Sign on to Dedicated Service Tools. The system displays the Use Dedicated 
Service Tools menu. If you are using logical partitions, and you wish to recover 
the primary partition, continue with the following steps. If you are not using 
logical partitions, continue with step|4] 

4. From the Use Dedicated Service Tools (DST) menu, select option 4 (Work with 
disk units). 

5. From the Work with Disk Units menu, select option 2 (Work with disk unit 
recovery). 
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6. From the Work with Disk Unit Recovery menu, select option 5 (Recover disk 
configuration). 
Press F10 to ignore problems and continue. 

(fa 


Problem Report 


Note: Some action for the problems listed below may need to 
be taken. Please select a problem to display more detailed 
information about the problem and to see what possible 
action may be taken to correct the problem. 


Type option, press Enter. 
5 = Display Detailed Report 


OPT Problem 
Load Source has been re-built 


ASPs will be cleared 
Kr of 


i > 


Confirm Recover Configuration 


ATTENTION: There are problems in the system that could cause 
some of the system data to be destroyed. 


Press F1l to display the problems. 
Press F1Q to confirm your choice to recover configuration. 
Press Fl2 to return to change your choice. 


Possible configuration found in the system records: 


Serial Resource 
ASP Unit Number Type Model Name Status 
More... 
F10=Confirm recover F12=Cancel 
Ss y 


7. Check the configuration of disk units on the display. The display shows the 
disk units that are assigned to each user ASP and to the system ASP (ASP 1). 
The warning on the display means that the system will clear all data on disk 
units in the system ASP. 


If this configuration is not correct, contact a service representative or software 
support for assistance. Do not proceed further without getting help. 


If the configuration that is shown is correct, press F10 to confirm the 
configuration. The system builds the configuration information and returns to 
the DST menu. 


8. Press F12 to cancel the DST menu. You are shown the IPL or Install the System 
menu. 


;— Stop! 
You have now completed recovering your disk configuration. Continue with 
the next step on your recovery checklist, which is restoring the operating 
system. 


Chapter 5. Recovering the Licensed Internal Code 145 


How to Start Your System After Restoring Licensed Internal Code 


Perform this procedure if you do not need to restore the operating system. After 
you complete loading the Licensed Internal Code, you should see the IPL or Install 
the System display: 


( IPL or Install the System ) 


Select one of the following: 

. Perform an IPL 

. Install the operating system 

. Use Dedicated Service Tools (DST) 

. Perform automatic installation of the operating system 


. Save Licensed Internal Code 
<e yy 


OrwWwNr 


Do the following: 


1. Select option 1 (Perform an IPL) on the IPL or Install the System menu. When 
the IPL completes, the Sign On display is shown. 


2. If your operator panel has a keylock switch, turn the key in the keylock switch 
to the normal position. 


3. Sign on the system as QSECOFR. 


4. If the Select Product to Work with PTFs display appears, press F3 (Exit) to 
continue the IPL. 


5. Press the Enter key in response to any messages that are displayed. 
6. When you are shown the IPL options display, type your choices and press the 


Enter key. 
Ve 
IPL Options >) 

Type choices, press Enter. 

System dates cisco sn vie ie) ee we ee ee 07 / 26 / 88 
SV SCOMEELMEL Ge 1c. xs nv betes este a ashen serves 12 = Q0° : 00 
Clear job: queues) <5 es eres se N 

Clear output queues =. < 4 6 sa 6 es N 

Clear incomplete job logs ....... N 

Starts printe wi lberSe toatss ye .c: se ea neene oe ‘f 

Start system to restricted state .... N 

Set major system options ........ ¥ 

Define or change system at IPL..... N 


;— Stop! 
You have now completed starting your system after recovering the Licensed 
Internal Code. Consult your recovery checklist to determine the next step in 
your recovery process. 
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Chapter 6. Restoring the Operating System 


This chapter describes the procedures for recovering the operating system. The 
procedure that is described here assumes that the Licensed Internal Code is 
already installed on your system. Normally, the Licensed Internal Code is installed. 
However, if the Licensed Internal Code is not on your system or is damaged, use 
the charts in [Chapter 4] to determine the correct recovery procedure for your 
situation. 


Why You Restore the Operating System: You might need to restore the operating 
system for several reasons, such as: 


* You are encountering problems with the operating system, such as damaged 
objects. 


* The software support center recommends it. 
* You have replaced a disk unit in the system ASP. 


* You are updating your system to a new release. See the following documents for 
procedures to install a new release of the iSeries server: 


— Software Installation 
— AS/400 Road Map for Changing to PowerPC Technology 


— Installation, upgrade and migration topic in the iSeries Information Center at 
http: //www.ibm.com/eserver /iseries /infocenter. 


Find These Things Before You Begin: 


* Your most recent SAVSYS media. One of the following creates a SAVSYS media 
volume: 


— Running the Save System (SAVSYS) command. 
— Using option 21 from the Save menu. 

-— Using option 22 from the Save menu. 

— Use of option 11 from the Run Backup menu. 


;_ Attention! 
DO NOT use a media volume that you created through DST by using 
option 5=Save Licensed Internal Code from the IPL or Install the System 
menu unless Software Services instructs you to do so. This process creates 
a media volume that does not contain the Licensed Internal Code PTF 
Inventory information or the OS/400 Operating System. If you perform the 
recovery process using this media volume, you will have to re-install the 
Licensed Internal Code from either a SAVSYS media volume or from your 
distribution media before you can load any PTFs onto your system. 


* If you do not have current SAVSYS media or they are damaged, you need the 
following: 


— The distribution media that is supplied by IBM 
— All the media for program temporary fixes (PTFs) that you have applied. 
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Attention! 
Use the distribution media only if you do not have SAVSYS media. If 
you use the distribution media to restore the operating system, the 
version you restore will not have any of the PTFs that you have applied. 
In addition, the restore sets the following default values that ship with 
the OS/400 licensed program: 


- System information 

- Network attributes 

- Configuration lists 

- Edit descriptions 

- Reply list entries 

- IBM-supplied subsystem descriptions 
- Passwords for IBM-supplied profiles 


* The list of all the PTFs applied to your system at the time you saved the entire 
system. You should attach this list to your backup log or keep it with your 
SAVSYS media. 

* The key or keystick for the system. 

* The DST password, if you have set up your system with the installation of the 
operating system secured. 

* The QSECOFR password that is associated with the SAVSYS media that you are 
using. 


Do These Things Before You Begin: 

* Clean the read and write heads of the tape unit if you are using a tape unit. 

* If your source system (the system that was saved and needs recovery) is 
operational, print a list of all the PTFs currently on the system, unless you 


printed the list before restoring the Licensed Internal Code. Type the following 
and press the Enter key: 


DSPPTF LICPGM(*ALL) OUTPUT (*PRINT) 


Choosing the Right Procedure for Restoring the Operating System 


You can restore the operating system in several different ways. At several points 
during the restore process, you need to make decisions based on which of these 
operations you are using: 


Complete Restore 
Use a complete restore operation if the operating system is not on your 
system or if it has damaged objects. This restores all the IBM-supplied 
objects in the QSYS library and the language libraries from media. 


Abbreviated Install 
Use an abbreviated install operation to replace parts of the operating 
system or system information, such as system values or the system reply 
list. 


Use the recovery checklist that you selected in [Chapter 4] to determine the correct 
procedure for your situation. You also need to know whether you are restoring 
from SAVSYS media or the IBM-supplied distribution media. Use the distribution 
media only if you do not have usable SAVSYS media. 
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How to Begin Restoring the Operating System: The steps you have already 
performed determine where you start: 


* If you have just restored or installed the Licensed Internal Code, you are doing a 
complete restore operation of the OS/400 program. You should see the IPL or 


Install the System display. Start with the steps described in 
OS/400 Licensed Program” 


* If restoring the operating system is the first step or only step in your recovery 
process, start by performing a manual IPL. The following section describes how 
to do this. 


How to Load the Operating System Using a Manual IPL 
Follow these steps to begin loading the operating system. Use these steps only if 
you have not just restored the Licensed Internal Code, as described in |Chapter 5 
To perform a manual IPL, do the following: 


1. Ensure that the tape unit, optical drive, or the CD-ROM unit is ready. For more 
information on loading the tape, optical media, or the CD-ROM, see the setup 
manual for the device. 


2. Load the first media volume from your most recent SAVSYS media in the 
appropriate device. If you do not have SAVSYS media or they are unusable, 
load the first CD-ROM from the distribution media. Use the distribution media 
only if no SAVSYS media exists. 


; Attention! 
DO NOT use media that was created through DST by using option 
5=Save Licensed Internal Code from the IPL or Install the System menu 
unless you have been instructed to do so by Software Services. Media 
created through this process does not contain the Licensed Internal Code 
PTF Inventory information or the OS/400 Operating System. If you 
perform the recovery process using this media, you will have to re-install 
the Licensed Internal Code from either SAVSYS media or from your 
distribution media before you can load any PTFs onto the system. 


Ensure the key or keystick is in the system unit. 
Place the system in manual mode. 
Ensure that all jobs are ended and all users are signed off. 


OF ON EO 


Power down the system. 


;— Attention logical partitioning users! 
If you are going to use this command on the primary partition, be sure to 
power off all secondary partitions before running the command. 


PWRDWNSYS OPTION(*IMMED) RESTART(*YES) IPLSRC(B) 


How to Restore the OS/400 Licensed Program 


You are ready to begin these steps when you have completed an IPL. Either you 
have just restored the Licensed Internal Code or you have just performed a manual 
IPL from your alternate IPL device. 
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Note: If you use Operations console, perform the following steps to reset your 
Operations console: 


1. On the IPL or Install the System screen, select 3, Use Dedicated Service 
Tools (DST). Press Enter to continue. 

2. Sign on to DST using a service tools user profile that has security 
officer authority and the assigned password. 

3. On the Use Dedicated Service Tools (DST) screen, select 5, Work with 
DST environment. Press Enter to continue. 

4. On the Work with DST Environment screen, select 2, System Devices. 
Press Enter to continue. 

5. On the Work with System Devices screen, select 6, Console Mode. Press 
Enter to continue. 

6. On the Select Console Type screen, select 2, Operations Console 
(Direct), or select 3, Operations Console (LAN). Press Enter to 
continue. 


Note: If you had to replace the load-source disk unit in the primary 
partition, you must use the directly attached console, option 2, 
to perform the restore operation. 


__7. Press F3 or F12 to get back to the IPL or Install the System screen. 


. You should see the IPL or Install the System display: 


(~ IPL or Install the System > 


Select one of the following: 

1. Perform an IPL 

2. Install the operating system 

3. Use Dedicated Service Tools (DST) 

4, Perform automatic installation of the operating system 
5 


. Save Licensed Internal Code 
X oy 


Task 1-—Starting to Restore the Operating System 


1. Load the first media volume from your most recent SAVSYS media in the 
appropriate device. If you do not have SAVSYS media or they are unusable, 
load the first CD-ROM from the distribution media. Use the distribution 
media only if no SAVSYS media exists. 


Attention! 
DO NOT use media that you created through DST by using option 
5=Save Licensed Internal Code from the IPL or Install the System menu 
unless you have been instructed to do so by Software Services. Media 
created through this process does not contain the Licensed Internal Code 
PTF Inventory information or the OS/400 Operating System. If you 
perform the recovery process using this media, you will have to re-install 
the Licensed Internal Code from either SAVSYS media or from your 
distribution media before you can load any PTFs onto the system. 


2. From the IPL or Install the System display, select option 2 (Install the 
operating system). 
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Note: Do not use option 4 (Perform automatic installation of the operating 
system) to restore the operating system. This option can only be used 
for installing the system and not for system recovery. 


Press the Enter key. 
The Confirm Install of the Operating System display is shown. 


Confirm Install of Operating System 


Press Enter to confirm your choice to install the operating system. Press 
Fl to return and cancel your choice to install the operating system. 


Press the Enter key. If you see the Dedicated Service Tools (DST) Sign On 
display, continue with step 5} If you see the Select a Language Group display, 
skip to step 

If your system is set up to prevent unauthorized installation of the operating 
system, you are shown the following display: 


Dedicated Service Tools (DST) Sign On 


Type choice, press Enter. 
DST user . 
DST password . 


Type the DST user and the DST password and press the Enter key. You see the 
Select a Language Group display. 
Notes: 


a. The DST user and DST password are case sensitive. Type QSECOEFR, the 
default user and password, in all capital letters. 


b. The DST user is the same as the shipped value for the password at the 
DST level. The DST user for security level DST is QSECOFR. 


c. If your current DST password does not work, the password may have 
been reset to the shipped value. Try QSECOFR as the DST password. 


d. For more information about preventing unauthorized installation of the 
operating system, see the iSeries Security Reference book. 


You are shown the Select a Language Group display: 


Select a Language Group 


Note: The language feature shown is the language feature installed on the 
system. 


Attention: To keep the same primary language, ensure that the media you use 
for installing the operating system matches the language feature shown. 
If the operating system media does not match what is shown, the 
installation process will attempt to install the operating system in a 
different language feature than Licensed Internal Code. 
This is undesirable. Type choice, press Enter. 


language teatunessn currency ce ber eeresa use oat ne) cunts Ve 2924 


This display shows the primary language currently on the save media that 
you are restoring. 


This value should match the value that is already on your system. If it does 
not, check to ensure that you have the correct save media. If you change the 
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value on the display, you will be prompted to insert different media to load a 
different language feature. Press the Enter key. You are shown the Confirm 
Language Feature Selection display. 


Confirm Language Feature Selection 


Kangudges feature’: 224.0 ie cece, iy colsdees teaes eo bsan woe one 2A 
Press Enter to confirm your choice for language feature. Installing the 
system will continue. Press F12 to return to change your choice for language 


feature. 


7. Press the Enter key to confirm the information. 


Note: If you have to change your system’s primary language, see the Software 
Installation book for more information. 


If you see the Add All Disk Units to the System display, continue with step 
If you see an IPL status message display, skip to step|10 on page 153 


8. This display is shown only if disk units are in nonconfigured status: 


a 


Add All Disk Units to the System > 
Select one of the following: 
1. Keep the current disk configuration 
2. Perform disk configuration using DST 
3. Add all units to the system auxiliary storage pool (ASP) 
4, Add all units to the system ASP and balance data J 


Disk units may be in nonconfigured status for these reasons: 


* The Licensed Internal Code was installed using option 2 or option 3. The 
recover disk configuration procedure was not run. All disk units except unit 
1 appear in nonconfigured status. 


* You have new or spare disk units that have not yet been configured on 
your system. 


Use the information in |Table 37|to determine how to respond to this display: 
Table 37. Configuring Disk While Installing the Operating System 


Your Recovery Situation 


How To Respond to the Display 


Restoring your entire system to a 
different system or to an upgraded 
system. 


If you plan to have user ASPs or mirrored protection you can select option 
2 to configure your disks now. Or, you can select option 1 now and 


configure the disks after you_have restored the operating system. Use the 
instructions in the section |Part 7, “Disk Configuration and Protection — 


if you plan to configure disk protection or user ASPs. 


If you want all disks in the system ASP and do not plan to have mirrored 
protection, select option 3. 


The Licensed Internal Code was 
installed on your own system using 
option 2 or option 3 during a 
recovery. 


If you want all disks in the system ASP and do not plan to have mirrored 
protection, select option 3. 


If you had user ASPs or mirrored protection on your system before the 
failure, you can select option 2 to reconfigure your disks. This removes any 
data from disks that show as not configured. 


You can select option 1 and configure your disks later. However, the 
system will not be able to recover the data on the disks that are not 
configured. 
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10. 


After selecting option 3, you receive an Attention Report display. Take the 
directed action for more detailed information, if necessary. Otherwise, press 
F10 to accept the problems and continue. 


If you installed the Licensed Internal Code using option 2, you receive an 
Attention report display. Take the directed action for more detailed 
information, if necessary. Otherwise, press F10 to accept the problems and 
continue. 

Following is an example of a status display. You may see several similar 
displays before the install the Operating System display is shown. These 
status displays do not require any action by the user. 


IPL Step in Progress 


IPL step... . : Storage Management Recovery 


The following list shows some of the IPL steps that are shown on the IPL Step 
in Progress display: 

* Authority Recovery 

* Journal Recovery 

* Database Recovery 

* Journal Synchronization 

* Start the Operating System 


Some of the IPL steps could take a long time. 


While the system is performing the IPL, system reference codes (SRCs) are 
displayed on the control panel of the system unit to indicate what step is in 
progress. The iSeries Service Functions book describes these SRCs. If the same 
SRC is displayed for a long time in solid (not flickering) lights, your system 
may have a problem completing the IPL. Look up the SRC in the iSeries 
Licensed Internal Code Diagnostic Aids - Volume 1 book or contact software 
support. 


The system may prompt you for additional volumes of your SAVSYS media or 
the distribution media. Follow the instructions on the display. 


After the IPL steps complete, the Install the Operating System menu appears: 


Chapter 6. Restoring the Operating System 153 


a IEE TUE eT IOR. Cee Puch RATES nr 


Install the Operating System 
Type options, press Enter. 
Install 
OPtION x. ass 1=Take defaults (No other 
options are displayed) 
2=Change install options 
Date 
NGa tie ssec arene cee = 00-99 
Month . 2... 01-12 
Dayar setters = 01-31 
Time: 
HOUM ce caketrcn os 00-23 
MINUTO =; sacs ce oe 00-59 
Second@ 2:3 i 00-59 
Be By 


11. Continue with Task 2. 


Task 2—Selecting the Installation Options 
1. Type your choice for the Install option prompt based on the following: 
* If you are doing a complete restore operation, select option 1 (Take defaults). 
This restores the entire operating system. Use this option if any of the 
following is true: 
— You are recovering from a failure of the load source unit. 
— You are restoring your entire system. 
— You are upgrading to a new system. 
— You are recovering damaged objects in your operating system. 


Note: If you are doing a complete restore operation and restoring a primary 
language other than English or if you have changed the shipped 
value of the QDATFMT system value, you must select option 2 
(Change install options). This ensures the language-dependent system 
values are restored correctly. 


Restoring to a different system? 
If you are restoring to a different system (with a different serial 
number) and you want your network attributes to be restored, select 
option 2 (Change install options). This will allow you to select to 
restore your network attributes from your save media. 


* If you are doing an abbreviated install operation, select option 2 (Change 
install options). This allows you to specify which parts of the operating 
system you want to restore. Use this option if you are recovering damaged 
system information, such as system values. Network attributes will not be 
restored. 

2. If the date and time are not correct, type new values. 


3. Press the Enter key. 


If you selected install option 1 (Take defaults), skip to step|14 on page 158 
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If you selected install option 2 (Change install options), you are shown the 
Specify Install Options display: 
Continue with step 


ig 


Specify Install Options ) 
Type choices, press Enter. 
Restore option... . __ 1=Restore programs and language objects 
from current media set 
2=Do not restore programs or 
language objects 
3=Restore only language objects 
from current media set 
4=Restore only language objects 
from a different media set using the 
current install device 
Job and output 
queues option... . __ 1=Clear, 2=Keep 
Distribute 0S/400 on 
available disk units __ l=Yes, 2=No y 


Ne 


4. Type your choice for the Restore option prompt based on the following: 


Note: If you are performing a complete system recovery, you must select 
option 1. 


1 = Restore programs and language objects 
This option restores system objects from the media that you are using. 
Use this option if damage to a system user profile is found. If you 
select the option, you will be prompted to specify whether to restore 
system information, edit descriptions, or the system reply list. 


Notes: 


a. 


If your system had access path recovery times for user ASPs and 
the user ASPs have not yet been reconfigured, the system cannot 
restore access path recovery times for the ASPs. Use the Edit 
Recovery Times for Access Paths (EDTRCYAP) command to set the 
times after you have reconfigured your ASP configuration. 


If you are restoring a primary language other than English, you 
must select option 1. 


2 = Do not restore programs or language objects 
This option leaves the current programs and language objects on the 
system. Select this option to do an abbreviated install of the operating 
system. 


When you select this option, the system does the following: 


Nothing is restored from media. Any damaged objects that the 
system deletes and creates again are empty. 


All libraries on the system are checked for damage. Damaged 
libraries are deleted and then created again. 


All system libraries (including QSYS) are created if they do not 
exist. 


Information associated with the user profiles is created if it does not 
exist or is damaged. 


The system entry-point table is created again. 
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3 = Restore only language objects from current media 
This option loads only those objects that make up the national 
language. The search for the language files begins on the current 
media. Select this option only if you need to change your primary 
language because you are recovering using the distribution media. 


4 = Restore only language objects from a different media 
This option loads only those objects that make up the national 
language. The system prompts you to insert the language media. 
Select this option only if you need to change your primary language 
because you are recovering using the distribution media. 


Note: Consult the Software Installation book if you want to change the 
primary language. You should avoid changing the primary 
language during a recovery. 


5. Type your choice for the Clear Job and Output Queues prompt based on the 
following: 


1 = Clear 
If you do not want to keep any spooled files or entries on job queues 
after the installation or if you know they are damaged, select this 
option. The system removes all jobs on job queues and spooled files. It 
re-creates any internal objects associated with them. You should select 
this option if you are performing an abbreviated installation of the 
operating system. This option also resets the counter for assigning 
unique job numbers. 


2 = Keep 
Any entries on job queues and output queues remain after the 
installation. This is the normal option for this prompt. 


6. Type your choice for the Distribute OS/400 on available disk units prompt based 
on the following: 


1 = Yes 


This option will take more time. You should only use this option in 
specific recovery situations as directed by your service representative. 
This option specifies to distribute OS/400 objects on available disk 
units in the system ASP during the installation process. 


2=No 
Specifies to not distribute OS/400 objects on available disk units. This 


option will restore OS/400 objects from the media over the existing 
objects on the system. 


7. Type your choices on the display and press the Enter key. 


If a did not specify 1 for the Restore option prompt, skip to step[14 on| 


If you specified 1 for the Restore option prompt, you are shown the Specify 
Restore Options display: 
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# 


Type choices, press Enter. 


Specify Restore Options 


Restore from the installation media: 


System information. . . _ 1l=Restore, 2=Do not restore 
Edit descriptions: <2 « l=Restore, 2=Do not restore 
Message reply list... _ l=Restore, 2=Do not restore 
Job descriptions. ... _ l=Restore, 3=Keep customization 
Subsystem descriptions. _ 1=Restore, 3=Keep customization 


Continue with step 


8. Type your choice for the System information prompt based on the following: 


Note: If you are performing a complete system recovery to a different system 
(with a different serial number), and you want to restore the network 
attributes from the save media, you must select option 1 (Restore). 


1 = Restore 
The system restores the system values and system management 
objects, such as access path recovery times, from media. Select this 
option if any of the following is true: 


* You received a message during a previous IPL stating that the 
system value object was created again. 


* You want to restore them to their values from your last save 
operation. 


* You restored the operating system using option 2 or option 3 from 
the Install Licensed Internal Code (LIC) display. 


* You are restoring a primary language other than English, or if you 
changed the shipped value of the QDATFMT system value. 


If you have changed your primary language since your last save 
operation, the system may change some language-dependent system 
values during the restore operation. 


2 = Do not restore 
The system values and system management objects that are currently 
on the system are not changed. 


A system value object must always be present on an operational 
system. If the system value object does not exist, the system restores 
it, even if you select option 2. 


Note: For more information about system values, see the System Values topic 
in the iSeries Information Center 
(http:/ /www.ibm.com/eserver/iseries /infocenter). For more 
information about access path recovery times, see the Journal 
Management topic in the iSeries Information Center 
(http:/ /www.ibm.com/eserver /iseries /infocenter). 


Type your choice for the Edit descriptions prompt based on the following: 
1 = Restore 
The system restores the edit descriptions from media. Select this 
option if: 
* The edit descriptions are damaged. 
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10. 


11. 


12. 


13. 
14. 


* You want to restore them to their values from your last save 
operation. 


* You installed the Licensed Internal Code by using option 2 or 
option 3 from the Install Licensed Internal Code (LIC) display. 
2 = Do not restore 
The edit descriptions currently on the system are not changed. 
Type your choice for the Message Reply List prompt based on the following: 
1 = Restore 
The system restores the reply list from media. Select this option if: 
* The message reply list is damaged. 
* You want to restore it to its values from your last save operation. 
* You installed the Licensed Internal Code by using option 2 or 
option 3 from the Install Licensed Internal Code (LIC) display. 


2=Do not restore 
The message reply list currently on the system is not changed. 


The default for these options is 2 if the operating system is loaded on the 
system. The default is 1 if the operating system is not already loaded. 


Type your choice for the Job descriptions prompt based on the following: 


1 = Restore 
The system restores the job descriptions from media. 


3 = Keep customization 
The system restores the objects from media and customizes them with 
the values from the same objects that are already on the system. 


Type your choice for the Subsystem descriptions prompt based on the following: 


1 = Restore 
The system restores the subsystem descriptions from media. 


3 = Keep customization 
The system restores the objects from media and customizes them with 
the values from the same objects that are already on the system. 


Type your choices on the display and press the Enter key. 


The Installation Status display indicates how many program or language 
objects have been restored. They are for your information only and require no 
response. 
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Message ID. . . :  CPI2070 0S/400 Installation Status 
Stage 2 t---------------------- 2-2-2 2-2-2 22 == ----- + 
| XXXXXXX | 
fe eee ee ee ae a a a + 
) 20 40 60 80 100 
Installation Objects 
Stage Completed Restored 
1 Creating needed profiles and libraries ....: X 
>> 2 Restoring programs to library QSYS......: XXXX 
3 Restoring language objects to library QSYS .. : 
4 Updating program table. 2. < ss 6 ee a wt 
5. ‘Installing database files. .....2. 6 2 6 5 ee 6 3 
6 Completing iSeries installation. .......: 


o 


15. Continue loading media in sequence when messages are shown that ask you 
to load additional media. The system searches through the media and loads 
the necessary programs and language information. After processing all the 
system save media or distribution media, the system may display the 
following message at the bottom of a blank display: 


Operating system has been installed. IPL in progress. 


When the IPL is complete, the IPL Sign On display is shown and the system 
in ready to complete the IPL. Continue with the next task. 


Task 3-Selecting IPL Options 


1. Sign on as QSECOFR. The password for QSECOFR depends on the recovery 
steps you have performed: 


* If you restored the operating system without first restoring the Licensed 
Internal Code, the QSECOFR password was not changed during the restore 
process. 


* If you used option 1 to restore the Licensed Internal Code before you 
restore the operating system, the system associates the QSECOFR password 
with your SAVSYS media. 


* If you used option 2 or option 3 to install the Licensed Internal Code before 
you restore the operating system, the system requires no password at this 
time. The system displays the Change Password display. The system sets 
the QSECOFR user profile to *EXPIRED, and the system sets the password 
to QSECOER. The system restores the system security level after you install 
the operating system and the IPL completes. When the IPL completes, the 
QSECOEFR password is the password associated with the SAVSYS media 
you used. 


Note: If you do not know the QSECOFR password, you can use DST to reset 
the password to its shipped value of QSECOFR. 
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a ae a. 


Change Password 
Password last changed ...... xx/Xx/XX 
Type choices, press Enter. 
Current password. ...... QSECOFR 
Newspassword! = 3 2: 6 4. arcs 


New password (to verify)... 


Ns = 


2. Press the Enter key. Informational messages are displayed. 
3. If the Select Product to Work with PTFs display appears, press F3 (Exit) to 


continue. 
( Select Product to Work with PTFs . 
ROSid GION CO! sass, cp eet he ons Product 


Type options, press Enter. Press F21 to select all. 
1=Select 


Product 
Opt Product Option Release 
5722999 *BASE V5R2M0 
5722SS1 *BASE V54R2M0 


4. You are shown the IPL Options display: 
(e > 


IPL Options 


Type choices, press Enter. 


SySitemeda tGameeesme. crc setae are a mn a, mice 07 / 26 / 88 
System Gime (20s ee cee a ees ee ee 12 : 00: 00 
Clear: gob: queues <.. 6% 4 ese es N 
Clear output queues .......... N 
Clear incomplete job logs ....... N 
Start primtewriters. <0. ty 20 sce ee Y 
Start system to restricted state . N 


Set major system options ........ Y 
Cae or change system at IPL..... ¥ 


The values that appear as defaults depend on the recovery steps you have 
performed. 

5. If the system date and system time are not correct, type the correct values. If 
you installed the Licensed Internal Code using option 2 or option 3, the date 
and time may be blank. The system date must have a year value in the range 
of 87 to 99, or 00 to 22. 


6. Type your choice for the Start print writers prompt based on the following: 
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9. 
10. 


N= No 
Select this value if you are going to restore user profiles, device 
configuration objects, user libraries, and authorities. 


Y = Yes 
Select this value if you have completed your recovery. 


Type your choice for the Start system to restricted state prompt based on the 
following: 


Y = Yes 
Select this value if you are going to restore user profiles, device 
configuration objects, user libraries, and authorities. Only the console 
is started (varied on). 

N = No 
Select this value if you have completed your recovery. All devices are 
started. 

Type Y (Yes) for the Set major system options prompt. 

Type Y (Yes) at the Define or change system at IPL prompt. 

Type your choices on the display and press the Enter key. Continue with the 

next task. 


Task 4—-Setting Major System Options 


1. You are shown the Set Major System Options display: 
fe 
Set Major System Options =) 

Type choices, press Enter. 

Enable automatic configuration. ..... Ne Y=Yes, N=No 

Device configuration naming ....... *NORMAL *NORMAL, *S36, 

*DEVADR 

Default special environment. ....... *NONE *NONE, *S36 

S / 
2. If you choose to enable automatic configuration, the system will create a 


device description for every device that is attached to your system. The device 
description will be named according to the value that you specify for Device 
configuration naming. You may need to change the names and descriptions of 
these device descriptions later. 


If you choose not to enable automatic configuration, you will need to configure 
at least one device later in your recovery. You must configure the device after 
you finish restoring the operating system and before you restore any other 
information. You may also need to correct the device_configuration for the 
system console and respond to SRC A900 2000 (step |10 on page 165). The 
instructions to recover from SRC A900 2000 are provided. 

Type your choices and press the Enter key. 

If you specified Y_for the Define or change system at IPL prompt in step 4 of Task 


3, continue with |“Task 5—Defining or Changing the System at IPL” on page 162 
If you specified N for the Define or change system at IPL prompt in step 4 of Task 


3, skip to|“Task 6-Completing the IPL” on page 164 
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Task 5—Defining or Changing the System at IPL 


1. 


If you specified Y for Enable automatic configuration on the Set Major System 
Options display, skip to step [3] If you specified N, continue with step 2] 


. If you have chosen not to enable automatic configuration, you must change the 


QIPLTYPE system value. Do the following: 


a. From the Define or Change the System at IPL menu, select option 3 (System 
value commands). Press the Enter key. 


b. Select option 3 (Work with system values) and press the Enter key. 


c. Type a 2 in the Option column next to the system value QIPLTYPE and 
press the Enter key. 


d. Change the value to 2 and press the Enter key. 
e. Press F12 until you return to the Define or Change the System at IPL menu. 


When you are recovering your system, there are some system values that must 
be set correctly to prevent the recovery from failing. Also, if you restore the 
system from distribution media, your system values will be reset to the 
IBM-supplied defaults. 


Use whatever documentation you have to set the system values to the correct 
settings for your installation. 


;_ Attention! 
If you are restoring to a system with a different processor or memory, you 
must ensure that the QMCHPOOL, QBASPOOL, and QPFRADJ system 
values are correct. 


As a general rule, if the main storage size is 64M or larger, change the 
QMCHPOOL system value to be 15 percent of the main storage size. If the 
main storage size is less than 64M, change the QMCHPOOL system value 
to be 20 percent of the main storage size. For a more precise setting of the 
QMCHPOOL system value, refer to the Work Management book. 


The QBASPOOL system value should be equal to the size of all the 
unallocated storage. 


The QPFRADJ system value should be set to 2. 


a. From the Define or Change the System at IPL menu, select option 3 (System 
value commands) and press the Enter key. 
b. Select option 3 (Work with system values) and press the Enter key. 


c. Type a 2 in the column next to the QALWOBJRST, QJOBMSGOFL, 
QVFYOBJRST, and any other system values that you want to change and 
press the Enter key. 

d. Change the QALWOBJRST system value to *ALL, change the 
QJOBMSGOQEFL system value to *PRTWRAP, and change the QVFYOBJRST 
system value to 3 or lower. Change any other system values that you want 
to change and press the Enter key. 


e. Press F12 until you return to the Define or Change the System at IPL menu. 
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Note: Some system values cannot be changed at this time. You will need to 
change these values later in the recovery process. After the IPL 
completes, you should check to ensure that the system values you 
changed in |3|are correct. 


If you are restoring to the same system from your SAVSYS media, skip to[5| 


. If you are restoring to a different system with a different serial number, and 


you selected install option 1 (Take defaults) on the Install the Operating 
System menu, the following network attributes are reset to the shipped values. 


If you selected install option 2 (Change install options) on the Install the 
Operating System menu, and selected option 1 (Restore) at the System 
Information field on the Specify Restore Options display, the network attributes 
will be restored. 


° System name 

* Local network ID 

* Local control point name 

* Default local location name 
* Default node 

* Default type 

¢ Maximum number of intermediate sessions 
* Route addition resistance 

¢ Network node servers 

* Alter primary focal point 

* Alert default focal point 


If you are restoring from distribution media and have previously changed the 

network attributes from the IBM-supplied defaults, you need to reset them. Do 

the following: 

a. From the Define or Change the System at IPL menu, select option 4 
(Network attributes commands) and press the Enter key. 

b. Select option 2 (Change network attributes). Press the Enter key to display a 
list of network attributes. 

c. Change the values to the correct network attributes and press the Enter key. 

d. Press F12 (Cancel) to return to the Define or Change the System at IPL 
menu. 


. If you are partially restoring (only some libraries), continue with step|64| 


Otherwise, skip to step 


. If you are partially restoring, you need to make sure that all libraries specified 


in the QSYSLIBL and QUSRLIBL system values are on the system. Do the 
following: 


a. From the Define or Change the System at IPL menu, select option 3 (System 
value commands). Press the Enter key. 


b. Select option 3 (Work with system values) and press the Enter key. 


c. Type a 2 in the Option column next to the system values you want to 
change and press the Enter key. 


d. Change the values to the correct values and press the Enter key. 
e. Press F12 to return to the Define or Change the System at IPL menu. 


. Continue with|”Task 6-Completing the IPL” on page 164 
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Task 6—Completing the IPL 


1. Press F3 to continue the IPL. 
2. The following display is shown during the IPL process (attended mode) when 
system _access paths are marked for rebuild: 
“Task 2—Using the Edit Rebuild of Access Paths Display” on page 174 
a > 


Edit Rebuild of Access Paths 
05/12/90 13:49:34 


OPE thiresholliditsm-wry cuageee tesa oe emesencaes 50 = =©0-99 


Type sequence, press Enter. 
Sequence: 1-99, *OPN, *HLD 


Sl alatatetatalatetatate Access Paths---------- Unique Rebuild 
Seq Status File Library Member Keyed Time 
Gan IPL QAPZSYM2 QSYS QAPZSYM2 NO 00:00:01 J) 


describes how to interpret and update this display. 


A status message is sent to notify the user that the system is performing 
access path recovery. 

3. Make any changes and press the Enter key. If you have made changes, the 
Edit Rebuild of Access Paths display is shown again confirming your changes 
or showing your error messages. Repeat this step until the Display Access 
Path Status display is shown or the IPL continues. 

4. The Display Access Path Status display is updated every 5 seconds while the 
system is rebuilding access paths: 


a 
Display Access Path Status n 
TPES Thresholdts Sse er 3 50 
atalatatatatetetated Access Paths---------- Rebuild Current 
Status File Library Member Build Time Run Time 
RUN QAPZSYM2 QSYS QAPZSYM2 00:00:01 00:00:01 
JRN QAPZREQ2 QSYS QAPZREQ2 00:00:01 
SYS QASULEO3 QSYS QASULEO3 00:00:01 
ie QASULEO1 QSYS QASULEO1 00:00:01 ) 


If you want to make changes, press F12 (Cancel) to return to the Edit Rebuild 
of Access Paths display. If all access paths are rebuilt or you no longer want to 
see the display, press F3 (Exit and continue IPL). 


Note: The rebuild of access paths requires system memory. It is recommended 
that you avoid a high level of system activity so that the rebuild of 
access paths can complete. 


5. The following display is shown if referential constraints need to be verified: 
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a a 


Edit Check Pending Constraints 
03/30/94 10:09:27 


Type sequence, press Enter. 
Sequence: 1-99, *HLD 


noon n------ Constraints----------- Verify Elapsed 
Seq Status Cst File Library Time Time 
Ve AFTIPL CSTF1 FILE567890 LIB4567890 00:00:56 00:00:00 S) 


“Task 3-Using the Edit Check Pending Constraints Display” on page 175 


describes how to interpret and update this display. 

6. Make any changes and press the Enter key. The Edit Check Pending 
Constraints display is shown again confirming your changes or showing your 
error messages if you have made changes. Repeat this step until the Display 
Constraint Status display is shown or the IPL continues. 


7. The Display Constraint Status display is updated every 5 seconds while the 
system is verifying constraints: 


fa | , >) 
Display Constraint Status 
TRIE Threshold: |. 2s. k ee 50 
wonnennn-- Constraints----------- Verify Elapsed 

Status Constraint File Library Time Time 

RUN CUST1 CUSTMAST CUSTLIB 00:00:04 00:00:01 

RUN CUST2 CUSTMAST CUSTLIB 00:00:05 00:00:01 

ee ORDHST1 ORDHIST ORDLIB 00:00:23 00:00:00 y 


If you want to make changes, press F12 (Cancel) to return to the Edit Check 
Pending Constraints display. Press F3 (Exit and continue IPL) if all constraints 
are verified or you no longer want to see the display. 


8. Press the Enter key if QSYSOPR messages are displayed. 


9. Press the Enter key to continue. If you restore the operating system from 
distribution media, you may have a problem with sending messages or 
creating documents if you have OfficeVision. To prevent errors, enter the 
following command: 


MRGMSGF QOFC/QZOFCMSG QSYS/QOFCMSG 


10. You may receive A900 2000 on the control panel or message CPF0975, Console 
did not vary on, on the console display. This occurs if your system 
configuration was lost and you have disabled automatic configuration. The 
system has created device description QCONSOLE to allow you to continue 
the restore operation. You may also receive SRC A900 2000 if you perform an 
IPL when the QIPLTYPE system value is set to 2. Do not create a user-defined 
device description for the console display. This can cause unpredictable 
results. 


If you receive this message, perform the steps that are described in 
“Recovering from SRC A900 2000” on page 166}before continuing. 
11. If you restored from the distribution media by using a 1/4-inch cartridge tape 


drive, the light on the tape drive may still be on. After the system has finished 
restoring the operating system, you may remove the tape while the light is on. 
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; Stop! 
When the Sign On display appears, you have completed restoring the 
operating system. Consult your recovery checklist for the next step in your 
recovery process. 


Recovering from SRC A900 2000 


When you restore the operating system, you may see SRC A900 2000. This happens 
when you use option 2 or option 3 to install the Licensed Internal Code and 
automatic configuration is not active while you are restoring the operating system. 
Before you can continue your recovery operations, you must create a device 
description and possibly a controller description to finish the restore operation. Do 
not create a user-defined device description for the console display. 


Creating a Configuration for 34xx Tape Units 


If your tape unit is a 3422, 3430, 3480, or a 3490, and you want to use a tape 
controller, do the following: 


Note: The following steps do not apply to the 3490 Models E and F. For these 
models refer to |“Creating a Configuration for Other Tape Units” on 
page 167 


1. Use the Work with Hardware Resource (WRKHDWRSC) command to 
determine the location of the tape controller. 


WRKHDWRSC TYPE (*STG) 
2. Create the controller description for the tape controller by doing the following: 


a. Locate the resource name for the tape controller on the Work with Storage 
Resources display. The value 34xx is displayed in the Type column. 


b. Write down the name of the resource. 

c. Type a 9 (Work with resource) in the OPT column next to name of the tape 
controller and press the Enter key. You see the Work with Storage Resources 
display. 

d. Type 5 (Work with controller descriptions) in the option column in front of 
the tape controller. You see the Work with Controller Descriptions display. 

e. Type 1 (Create) in the option column on the top line. 


f. Type the controller name (such as TAPCTLO1) in the description field and 
press the Enter key. You see the Create Controller Description display. 


g. If necessary, type additional information on the display. Then press the 
Enter key. You return to the Work with Controller Descriptions display. 


h. If the controller description that you created does not appear, press F5 
(Refresh). 


3. To create device descriptions for the tape units that are attached to the 
controller, do the following: 


a. On the Work with Controller Descriptions display, press F23 (More options). 
The list of options changes. 


b. Type 9 (Work with associated descriptions) in the option column in front of 
the tape controller. You see the Work with Associated Descriptions display. 


c. Locate the resource for the tape unit. Because no device description exists, 
the description says *NONE. 


d. Write down the name of the tape resource. 
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4. 


Creating 


e. Type a 1 (Create) in the Opt column next to the description of *NONE and 
press the Enter key. You see the Create Device Desc (Tape) (CRTDEVTAP) 
screen. 


f. In the Device description field, type a name such as TAPO1. 


g. Inthe Resource name prompt, type the name that you wrote down in step |3d| 
ion page 166] (If you did not write it down, press F12 to return to the 
display. Repeat steps |3d] through Bel) 


h. Press the Enter key. 
i. Additional parameters appear on the display. 


j. If necessary, type additional information on the display. Then press the Enter 
key. You return to the Work with Associated Descriptions display. 


k. Press F5 (Refresh). The name of the description that you created should now 
be associated with the resource. 


|. Type 8 (Work with configuration status) in front of the controller description 
and the device description. You see the Work with Configuration Status 
display. 
m. Type 1 (Vary on or Make available) in front of the controller and the 
devices. 


Press F3 until your return to your original menu. 


a Configuration for Other Tape Units 


If you are not using a 34xx tape unit, or want to create a 34xx (3490 Model E or F) 
tape unit without a controller, do the following: 


1. 


10. 


Use the Work with Hardware Resource (WRKHDWRSC) command to 
determine tape controller name. 


WRKHDWRSC TYPE(*STG) 

Locate the tape controller on the Work with Hardware Resources display. 
Type a 9 (Work with resource) next to tape controller name and press the 
Enter key. 

Locate the resource name for the tape unit (for example, TAP01). 

Enter a 5 (Work with Configuration Descriptions) in the Opt column next to 
the tape resource name and press the Enter key. 

You are shown the Work with Configuration Descriptions display. 

Type a 1 (Create) in the Option field and a device description name (for 
example, TAP01) in the Description field. Press the Enter key. You are shown 
the Create Device Description display. 

Change any values that you want to change, then press the Enter key (twice) 
to create the device description. You are shown the Work with Configuration 
Descriptions display again. The device that you created should appear on the 
display. 

Type an 8 (Work with configuration status) in front of the new device 
description. You are shown the Work with Configuration Status display. 

Type a 1 (Vary on) in front of the new device. If the status does not change to 
Varied On, wait a few minutes. Then press F5 (Refresh). If the status still does 
not change to Varied On, follow normal problem determination procedures for 
the device. 


Press F3 until you return to the main menu. 


SRC A900 2000 remains displayed on the control panel throughout the remaining 
restore operations. When the final IPL of the system is complete, SRC A900 2000 
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disappears. The user-defined device description for the console display will be 
restored when the Restore Configuration (RSTCFG) command is run later in the 
recovery. 


r— Stop! 
When the Sign On display appears, you have completed restoring the 
operating system. Consult your recovery checklist for the next step in your 
recovery process. 
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Chapter 7. Starting the System After It Ends Abnormally 


When your system stops normally, it does the following: 


Writes changed pages of information from memory to auxiliary storage. 
Closes access paths and files. 
Ends programs and jobs at the natural stopping points. 


If your system stops without having time to do these things, it is called an 
abnormal end. Your system might end abnormally for the following reasons: 


A power failure. 


A disk failure, if you do not have mirrored protection or device parity 
protection. 


A failure in the processor. 
Failure of a critical operating system program. 
Operator action (forced power down). 


What Happens When Your System Stops 


The following list describes circumstances that cause your system to stop 
unexpectedly and what happens: 


Power failure with uninterruptible power supply: When the system loses 
normal power, the uninterruptible power supply system takes over and keeps 
the system running. The system detects this change and sends a message to your 
power-monitoring program. Your program can decide whether to keep the 
system running until power returns or to begin an orderly shutdown. 


Power failure with no protection: If your system does not have an 
uninterruptible power supply feature and the power fails, your system stops 
immediately. The contents of main memory are lost. The system must 
reconstruct information when power returns. This can be very time-consuming. 
Whether the system starts automatically depends on how you have set the 
QPWRRSTIPL system value. 


Disk failure with device parity protection or mirrored protection: In many 
cases, the system can continue running without full disk protection until the 
failed unit is replaced. 


Disk failure without disk protection: This is like a power failure without 
protection. The system stops immediately. The system must reconstruct 
information about jobs that were running and files that were open after the disk 
is repaired or replaced. 


Failure of a critical operating system program: The system will stop 
immediately, just as it does if an unprotected power failure or disk failure 
occurs. The system attempts to copy the contents of main memory so that the 
problem can be analyzed. This is called a main storage dump. When the system 
stops, you will see the Main Storage Dump Manager Occurred display. See 
[Using the Main Storage Dump Occurred Display” on page 170]for more 


information about this display. 
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Using the Disk Configuration Error Report Display 


When your system starts, it checks to ensure that it can access all of the disk units 
that are configured. If it cannot access one or more disk units, you are shown the 
Disk Configuration Error Report display: 


C Disk Configuration Error Report ) 


Type option, press Enter. 
5=Display Detailed Report 


OPT Error 


_ Missing disk units in the configuration 
Ne y 


Following a temporary power outage, you may see this display because power has 
been restored to the processor but not to the peripheral devices. Wait to respond to 
the display until power is restored to all the disk units. The system’s ability to 
access all the disk units when the system is starting is important for a successful 
recovery. If disk units are not available, the system may not be able to recover 
changed pages of memory. This can lengthen the time it takes to perform the IPL. 


This screen may also be presented: 
* After abnormal termination if the system is unable to activate all of the DASD 
on the re-IPL. 


* During any system IPL that has a similar problem, even if normal system 
shutdown had taken the system down last. 


Using the Main Storage Dump Occurred Display 


If your system encounters a serious software problem, you are shown the Main 
Storage Dump Occurred display: 
fe ~ 


Main Storage Dump Occurred 


S/N XXXXXXXX 


The system has failed. Report the following information to 
your IBM service representative. 


SRC word 1...... :  A1DO03000 
SRC word.2) sw ae | COOBOOTSE 
SRC word 3... ...: + 0000308F 
SRO, word 4.5543 4403) SREFDEOO 
SRE word 5:4 a saw se OEZ11008 
SRC word 6......: 00000000 
SRC word 7... ...: 00000000 
SRC word 8... ... : ~~ #£G0D5A400 
SRC word 9... ... :~=©00CDA400 
Type/Model/Feature . . : = XXXX XXXX XXXX 


Warning: The Main Storage Dump (MSD) must be copied for service. 
Failure to copy the Main Storage Dump will limit 
the ability to diagnose the failure. 


Press Enter to copy the MSD for service or view the MSD. 


F3=Exit F12=Cancel 
S 
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Follow the instructions of your service provider in responding to this display. In 
most cases, you should make a copy of the main storage dump. Save it either to 
save media or to auxiliary storage (disk), to assist with diagnosing the problem. 


The iSeries Service Functions book has more information about the Main Storage 
Dump Manager function. 


How to Restart Your System 


When you have solved whatever problem caused your system to stop, you must 
start it again. In some cases, you start the initial program load (IPL) yourself. In 
other cases, such as a power loss, the system starts automatically. When you start 
your system again after it ends abnormally, the system tries to put things back in 
order. It closes files that were in use, rebuilds access paths that were open, and 
verifies file constraints. This process can take a long time. 


If you want the system to determine when to rebuild and verify, perform a normal 
(automatic) IPL to restart your system. If you want to view and change the 
schedules for rebuilding access paths and verifying referential constraints, follow 
the steps in this chapter: 


Task 1—Performing an Attended IPL 


Perform an attended IPL so that you have the opportunity to change rebuild 
options. 


Note: Your service representative may have started the IPL already. If so, skip to 
the step in this task for the display that is currently shown on your system. 


To perform an attended initial program load (IPL), you must use the control panel 
on the system unit. The steps vary slightly based on the type of system unit that 
you have. Click on Basic system operations under the Systems management topic 
in the Information Center if you are unsure of the procedures for your system. You 
can find the Information Center at the following Web site: 


http://www. ibm.com/eserver/iseries/infocenter/ 


Do the following: 


1. If your system unit has a lock on the control panel, use the key or keystick to 
unlock the control panel. 


2. Place the system in Manual mode. 
Ensure that any switches for all disk units are in the On position. 


a 


. If your system is currently running, ensure that all users are signed off and all 
jobs are ended. 


;— Attention logical partitioning users! 
If you are going to use this command on the primary partition, be sure 
to power off all secondary partitions before running the command. 


Then type: 
PWRDWNSYS OPTION(*CNTRLD) DELAY(600) RESTART(*YES) 
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Note: For the delay parameter, specify a number of seconds that allows your 
system time to bring most jobs to a normal end. On a large, busy 
system, you may need a longer delay. 


5. If your system is not running, power on your system. 


6. When you see the IPL or Install the System display, select option 1 (Perform 
an IPL). Following is an example of a status display. These status displays do 
not require any action by the user. 


IPL Step in Progress 


IPL step 


The following list shows some of the IPL steps that are shown on the IPL Step 
in Progress display: 

* Authority Recovery 

¢ Journal Recovery 

* Database Recovery 

* Journal Synchronization 

* Start the Operating System 


Some of the IPL steps could take a long time. 


While the system is performing the IPL, system reference codes (SRCs) are 
displayed on the control panel of the system unit to indicate what step is in 
progress. The iSeries Service Functions book describes these SRCs. If the same 
SRC is displayed for a long time in solid (not flickering) lights, your system 
may have a problem completing the IPL. Look up the SRC in the iSeries 
Licensed Internal Code Diagnostic Aids - Volume 1 book or contact software 
support. 


7. Press the Enter key. Informational messages are displayed. 
8. If the Select Product to Work with PTFs display appears, press F3 (Exit) to 


continue. 
( Select Product to Work with PTFs +) 
Pos ttone Ooms hee coe Product 


Type options, press Enter. Press F21 to select all. 
1=Select 


Product 
Opt Product Option Release 
5722999 BASE V5R2M0 
5722SS1 *BASE  V5R2M0 


9. You are shown the IPL Options display: 
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IPL Options 


Type choices, press Enter. 


Systemadat emesis ceive bps re ance me es oe nO 2618/2 00 
SYStOMELIMG> y na See es ew le eee we 1200) 00 
Clear-job queues: <5 6 4 6 6 se em ON 
Clear output queues sey ess Bees aes tN 
Clear incomplete job logs ....... N 
Start. Print writers: 2%) a ee ee eS ¥ 
Start system to restricted state . N 


Set major system options ........ Ni 
Define or change system at IPL. .... yi 


The values that appear as defaults depend on the recovery steps you have 
performed. 


10. If the system date and system time are not correct, type the correct values. If 
you installed the Licensed Internal Code using option 2 or option 3, the date 
and time may be blank. The system date must have a year value in the range 
of 87 to 99, or 00 to 22. 


11. Specify these responses for the prompts on the display: 


Clear job queues 

Clear output queues 

Clear incomplete job logs 

Start print writers 

Start system to restricted state 
Set major system options 
Define or change system at IPL 


ZZ<K*K2Z22Z22Z2 


12. Enter your choices and press the Enter key. 
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Task 2—Using the Edit Rebuild of Access Paths Display 


If access paths are marked for rebuilding, you are shown the following display: 
fine 


Edit Rebuild of Access Paths SYSTEMA 
05/12/90 13:49:34 


DPieathre shold). 70 sb te lee ears en oct ces 50 =0-99 


Type sequence, press Enter. 
Sequence: 1-99, *OPN, *HLD 


wonnn-nn---- Access Paths---------- Unique Rebuild 
Seq Status File Library Member Keyed Time 
252 EPL QAPZSYM2 QSYS QAPZSYM2 NO 00:00:01 
2505 “EPI QAPZREQ2 QSYS QAPZREQ2 NO 00:00:01 
25. EPL: QAPZPTF3 QSYS QAPZPTF3 NO 00:00:01 
25 IPL QAPZPTF2 QSYS QAPZPTF2 NO 00:00:01 
2505 s0PI QAPZOBJ2 QSYS QAPZOBJ2 NO 00:00:01 
*OPN OPEN QTWALL QSYS QTWALL NO 00:00:06 
*OPN OPEN QASULTEL QSYS QASULTEL NO 00:00:01 
*OPN OPEN QASULEO5 QSYS QASULEO5 NO 00:00:01 
*OPN OPEN QASULEO3 QSYS QASULEO3 NO 00:00:01 
*OPN OPEN QASULEO1 QSYS QASULEO1 NO 00:00:01 
More. 


F5=Refresh F1l=Display member text F13=Change multiple F15=Sort by 
te Bepeat position to F17=Position to 


Note: No access paths are listed if all access paths that are marked for rebuild 
have a status of SYS, JRN, or SMAPP. 


While you are working with this display, the system is rebuilding access paths. You 
can use this display to: 


* Change the sequence in which access paths are rebuilt. 
* Delay rebuilding some access paths until after the IPL. 
1. If you_do not want to make changes to this display, press the Enter key. Skip to 


step |5 on page 175] If you want to make changes, continue with step 


2. You may change the value of the IPL threshold. All access paths with a 
sequence (SEQ) less than or equal to the threshold are rebuilt during the IPL. 
Access paths with a greater sequence number are rebuilt after the IPL 
completes. The default threshold is 50. 


3. You may change the sequence (SEQ) column on the display for specific access 
paths. Initially, the sequence numbers are set this way: 


25 Files with MAINT(*IMMED) and RECOV(*IPL) 
75 Files with MAINT(*IMMED) and RECOV(*AFTIPL) 
*OPN_ Files with MAINT(*DLY) 


Within a group (same sequence numbers), the system rebuilds access paths 
according to rebuild time, starting with the longest rebuild time. 


Rebuild time is an estimate, based on the file size and key length. For journaled 
access paths (status JRN) and access paths protected by system-managed 
access-path protection (status SMAPP), the rebuild time shows as 0. The system 
uses the journal entries to recover these access paths rather than rebuilding 
them. The time that is required is minimal. 
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The estimate for rebuild time assumes that the rebuild job is not contending for 
resources. If an access path is rebuilt after the IPL, the rebuild will probably 
take longer. 


4. Type your changes and press the Enter key. You are shown the Edit Rebuild of 
Access Paths display again. You see error messages if the system could not 
make some of the changes you requested. For example, you may have tried to 
change the sequence number for an access path that the system rebuilt while 
you were using the display. 


If you have errors, return to step [2 on page 174 


5. When you have finished the display, press the Enter key without making 
changes. You are shown the Display Access Path Status display: 
This display is updated every 5 seconds while the system is rebuilding access 


Display Access Path Status 
TPE hresholidis. 2. sa2 eo 50 
a alatatatatatatete Access Paths---------- Rebuild Current 

Status File Library Member Build Time Run Time 

RUN QAPZSYM2 QSYS QAPZSYM2 00:00:01 00:00:01 

JRN QAPZREQ2 QSYS QAPZREQ2 00:00:01 

SNS! QASULEQ3 QSYS QASULEO3 00:00:01 

IPL QASULEO1 QSYS QASULEO1 00:00:01 

= 
paths. 


6. If you want to make changes to the IPL threshold or the sequence for 
rebuilding access paths, press F12 (Cancel) to return to the Edit Rebuild of 
Access Paths display. Repeat steps through|5} 


If you do not want to make changes, you can allow the Display Access Path 
Status display to continue updating or you can press F3 (Exit and continue 
IPL). In either case, the system completes rebuilding access paths before 
continuing to the next step of the IPL. 


Task 3—Using the Edit Check Pending Constraints Display 


You can define required attributes for physical files on the system. The descriptions 
for these values are referential constraints or simply constraints. When you 
perform an IPL after the system ends abnormally or when you restore database 
files, the system checks the validity of file constraints. Look in the Information 
Center under the Database and File System topics for more information about 
using referential constraints. 


If database constraints are marked for verification, you are shown the following 
display: 
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(e ; > 
Edit Check Pending Constraints SYSTEMA 
03/30/94 10:09:27 
PP eth es holder cruises poker ow caine ed 50 0-99 
Type sequence, press Enter. 
Sequence: 1-99, *HLD 
ialatatataatatatad Constraints----------- Verify Elapsed 
Seq Status Cst File Library Time Time 
75 AFTIPL CSTF1 FILE567890 LIB4567890 00:00:56 00:00:00 
75 AFTIPL CSTF2 FILE567890 LIB4567890 00:00:56 00:00:00 
*HLD INVAP CSTF5 FILE567890 LIB4567890 10:30:06 00:00:00 
*HLD CHKPND CSTF6 FILE567890 LIB4567890 09:30:06 00:00:00 
*HLD HELD CSTF7 FILE567890 LIB4567890 08:30:06 00:00:00 
More... 
Xe 44 


You can use this display to do the following: 


Change the sequence in which constraints are verified. 
Have the system verify some constraints before the IPL completes. 
Delay verification for some constraints until you specifically request it. 


If you do not want to make changes to this display, press the Enter key and 
skip to step |5} If you want to make changes, continue with step 


You may change the value of the IPL threshold. All constraints with a sequence 
(SEQ) less than or equal to the threshold are verified during the IPL. 
Constraints with a greater sequence number are verified after the IPL 
completes. The default threshold is 50. 


You may change the sequence (SEQ) column on the display for specific 
constraints. Initially, the sequence for all constraints is set to 75. 


Within a group (same sequence numbers), the system verifies constraints 
according to verify time, starting with the longest estimated time. 


Verify that time is an estimate. The estimate assumes that the verify job is not 
contending for resources. If a constraint is verified after the IPL, the verify may 
take longer. 


If you want to delay the verification of a constraint indefinitely, specify *HLD for 
the sequence. You can use the Edit Check Pending Constraint (EDTCPCST) 
command later to set a sequence and have the system verify the constraint. 


Type your changes and press the Enter key. You are shown the Edit Check 
Pending Constraint display again. You see error messages if the system could 
not make some of the changes you requested. For example, you may have tried 
to change the sequence number for a constraint that the system verified while 
you were using the display. 


If you have errors, return to step 


When you have finished the display, press the Enter key without making 
changes. You are shown the Display Constraint Status display: 
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ee 


7. 


Display Constraint Status 


TREsthreshold xis fa eee 50 

---------- Constraints----------- Verify Elapsed 
Status Constraint File Library Time Time 
RUN CUST1 CUSTMAST CUSTLIB 00:00:04 00:00:01 
RUN CUST2 CUSTMAST CUSTLIB 00:00:05 00:00:01 
IPL ORDHST1 ORDHIST ORDLIB 00:00:23 00:00:00 


F3=Exit and continue IPL  F12=Cancel 


This display is updated every 5 seconds while the system is verifying 
constraints. 


If you want to make changes to the IPL threshold or the sequence for verifying 
constraints, press F12 (Cancel) to return to the Edit Check Pending Constraints 
display. Repeat steps}2} through 

If you do not want to make changes, you can allow the Display Constraint 
Status display to continue updating or you can press F3 (Exit and continue 
IPL). In either case, the system completes verifying constraints before 
continuing to the next step of the IPL. 


When the IPL completes, continue with |“Task 4—Recovering from Damaged 
Objects and Unreadable Sectors” 


Task 4—Recovering from Damaged Objects and Unreadable 


Sectors 


If your system stops without warning or disk errors occur, some object description 
information may not be updated correctly. If this happens, the object is considered 
damaged. When you perform an IPL, the system attempts to locate damaged 
objects and write them to the object recovery list. It writes a message (CPI18xx) to 
the history (QHST) log for each damaged object that it finds. If any damaged 
objects are added to the object recovery list during the IPL, message CPI8197 is 
sent to the QSYSOPR message queue. 


Note: Some damage, such as damage to the contents of a database file, may not be 


detected until the object is used. If you suspect that a large number of 
objects on your system have been damaged, contact your service 
representative for advice on how to recover. 


Do the following to check and recover damaged objects: 


1. 
2. 


a 


Display the QHST (history) log by typing DSPLOG and pressing F4 (Prompt). 
On the prompt display, fill in a starting date and time to limit the number of 
entries you see. 


On the display, fill in *PRINT for the Output prompt and press the Enter key. 
Type: WRKSPLF. You are shown a list of spooled files for your job. 


Locate the spooled file for the DSPLOG command. Use option 3 to hold the 
spooled file. 


Use option 5 to display the spooled file. 
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7. Look for entries for damaged objects that are not synchronized. You can use the 
Find function to search for lines that have these character strings: damage and 
sync. Following are some examples of messages you might see: 


CPF3113 

Member damaged 
CPF3175 

File is not synchronized 
CPF3176 

Data space is partially damaged 
CPF3171 

Journal is damaged 
CPF3172 

Objects are not synchronized with the journal 
CPF3173 

Journal receiver is damaged 
CPF3174 

Journal receiver is partially damaged 
CPF700C 

Object of type *object-type cannot be synchronized with journal. 
CPF81xx 


General messages about object damage 


8. Write down the names and types of the objects you find. Consult|Table 38) for 
the correct recovery procedure, based on the type of object that is damaged. 


Table 38. Recovery for Damaged Objects by Object Type 


Type of Object Recovery Procedure 

Operating system object in Contact software support for assistance. You may need to 
QSYS library install the operating system again. 

IBM-supplied user profile Perform an abbreviated installation of the operating system. 
Job description that is If no other workstation entries exist for the controlling 


specified on the workstation subsystem, the system is not usable. Contact software 
entry for the console in the support for assistance. 
controlling subsystem 


Job queue Perform an IPL. Restore or re-create the damaged job queue. 
All entries are lost. 
Output queue Perform an IPL. If the output queue is the default output 


queue for a printer, it is re-created and its entries are rebuilt. 
Other output queues must be restored or re-created. Their 
entries are not recovered. 
Damaged file whose name Delete the file. Restore it from a backup copy. Run the 
starts with QAOSS RCLDLO DLO(#DOCDTL) command. 
Database file See|“Recovering Damaged Database Files” on page 179 
Journal See|“Recovering a Damaged Journal” on page 181 
Journal receiver See|“Recovering a Damaged Journal Receiver” on page 182 
Journaled object See 


“Recovering a Journaled Object That Is Damaged or Not 


Synchronized” on page 182 


See|“Recovering Other Types of Damaged Objects” o 


9. Watch for additional indications that objects have been damaged. Some 
indications are: 


All others 
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* You cannot start the system because auxiliary storage is full. 


* The system has ended abnormally several times since the last time you ran 
the Reclaim Storage (RCLSTG) procedure. 

* You see objects on the Work with Objects by Owner display that have no 
library associated with them. 

* The system status display shows an unexpectedly high percentage of 
auxiliary storage that is used. 

* You cannot access the data in a database file because a member is damaged. 
Message CPF8113 indicates this. 


* You cannot access objects because a damaged authorization list or authority 
holder secures them. 


If you see these indications on your system, run the RCLSTG procedure. 
Running the procedure is described in}”Reclaiming Storage” on page 48 
If you see these indications after a disk unit was replaced and the data was 


restored from a partial pump, you should recover the entire ASP that contained 
the failed disk unit. See the appropriate checklist. 


Recovering Damaged Database Files 

Performing a special IPL during which the system analyzes every disk segment for 
parts of database objects can recover some types of object-level damage to database 
files. Following are examples of object-level damage: 

* Lost pointers between the index (access path) and the data. 


* Unidentified objects on the object recovery list. 


If you are experiencing problems with database files, you can display the Licensed 
Internal Code log to determine whether a special IPL may resolve the problems. 


Note: You must have *SERVICE special authority to perform the tasks that are 
described in this topic. 

Do the following: 

1. Type STRSST and press the Enter key. You are shown the System Service Tools 
(SST) menu menu. 

2. Select option 1 (Start a service tool). You are shown the Start a Service Tool 
display. 

3. Select option 5 (Licensed Internal Code log). You are shown the Licensed 
Internal Code Log display. 

4. Select option 1 (Select entries from the Licensed Internal Code log). You are 
shown the Specify Licensed Internal Code Log Selection Values display. 
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_ 


Specify Licensed Internal Code Log Selection Values 


Type choices, press Enter 


Note ID: 

StantaimG! 2... 29 Rueences bee e esu ee FFFFFFFF Q0Q00Q00-FFFFFFFF 
Entry type: 

Majiorecodes 35 wa ce te eo aes 0600 O000-FFFF 

Minorcode ) s-s 527 8 aos eS 145F 0000-FFFF 
Starting: 

Dates Ss Scns Soe es ce 00/00/00 MM/DD/YY 

MANM@ se aes esr eee oer oe cet es esis ee 00:00:00 HH:MM:SS 
Ending 

Date. Sth ck Se eee tr 00/00/00 MM/DD/YY 

MGTIM@ So, Parey tog ce Coc gen eve ee en res 00:00:00 HH:MM:SS 


F3=Exit F12=Cancel 


Type 0600 for the Major code prompt. 
Type 145F for the Minor code prompt. 


For the starting date and time, enter values that approximate when you first 
started to have problems. 

For the ending date and time, enter the current date and time. 

Press the Enter key. If any errors have been recorded that may be resolved by a 
special IPL, you are shown a list of the entries. Otherwise, you receive a 
message that no log entries matched your criteria. 


If you have log entries that suggest a special IPL, you need to schedule a time for 
this IPL. It may take many hours for the system to analyze all the disk segments. 
As a rough estimate, the analysis phase of the IPL will take approximately 1 
second for each object on your system. 


When you are ready to perform the IPL, do the following: 


1. 


2. 


Place your system in a restricted state. See 
Restricted State” on page 47 

Type STRSST and press the Enter key. You are shown the System Service Tools 
(SST) menu menu. 

Select option 1 (Start a service tool). You are shown the Start a Service Tool 
display. 

Select option 4 (Display/Alter/Dump). You are shown the 
Display/Alter/Dump Output Device display. 

Select option 1 (Display/Alter storage). You are shown the Select Data display. 


Select option 5 (Starting address). You are shown the Specify Starting Address 
display: 


180 08/400 Backup and Recovery V5R2 


Specify Starting Address 
Qutput device ......:  Display/Alter storage 
Type choice, press Enter. 


AddVeSS: 3s cae esr eset Q00000000E 000000 


7. Type 900000000E 000000 for the address and press the Enter key. You are 
shown the Display Storage display: 


Display Storage 


CONEROI!| “3 a et cee ee nnnnn, Pnnnnn, Lcccccc, .cccccc, 
AdAVOSS» ance ce Sp en ces OODOOOD000E 000000 

0000 20830048 00800000 00000000 OE00000000 Has aiejai sire toile svevecenarsrore 
0010 00010000 00000000 00000000 0000000000 He Siaavs iaveielteliesevenevenaiecers 


0020 00000000 00000000 00000000 0000000000 ae SHO HOD UOTE 


> 


8. On the third data line (offset 0020), type 8 in the first character. Press F11 
(Alter storage) to make the change take affect. 


9. Press F3 until you return to the Exit System Service Tools display. 
10. Press the Enter key (continue ending SST). 
11. On the command line, type 
PWRDWNSYS OPTION(*IMMED) RESTART (*YES) 


This causes the system to begin the special IPL. 


;— Attention logical partitioning users! 
If you are going to use this command on the primary partition, be sure 
to power off all secondary partitions before running the command. 


Recovering a Damaged Journal 
Note: The following steps only apply to recovering a damaged local journal. 


Do the following: 
1. Type WRKJRN. 


2. On the prompt display, type the name of the journal. You are shown the Work 


with Journals display: 


y 
Work with Journals >) 
Type options, press Enter. 
2=Forward recovery 3=Backout recovery 5=Display journal status 
6=Recover damaged journal 7=Recover damaged journal receivers 
9=Associate receivers with journal 
ASP 
Opt Journal Library Device Text 
JRNACC DSTA1 JOURNAL FOR ACCOUNTS yy 
3. Select option 6 (Recover damaged journal). 
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4. Type: WRKJRNA JRN(library-name/journal-name) OUTPUT(*PRINT). You receive 
a listing that shows all the objects that are currently being journaled. 


5. Start journaling for any physical files that should be journaled but are not on 
the list by using the STRJRNPF command. 

6. Start journaling for any access paths that should be journaled but are not on 
the list by using the STRJRNAP command. 

7. Start journaling for any integrated file system objects that should be journaled 
but are not on the list by using the STRJRN command. 

8. Start journaling for any other object types that should be journaled but are not 
on the list by using the STRJRNOBJ command. 


9. If you previously had any remote journals that were associated with the 
damaged journal, add those remote journals again. You can add the remote 
journals by using the Add Remote Journal (QjoAddRemoteJournal) API or the 
Add Remote Journal (ADDRMTJRN) command. 


10. Save each journaled object. You should always save objects after you start 
journaling them. 


Recovering a Damaged Journal Receiver 


Note: The following steps only apply to recovering a damaged journal receiver 
that was attached to a local journal. 


Do the following: 
1. Type WRKJRN. 


2. On the prompt display, type the name of the journal that is associated with the 
damaged journal receiver. You are shown the Work with Journals display: 


ia > 


Work with Journals 


Type options, press Enter. 
2=Forward recovery 3=Backout recovery 5=Display journal status 
6=Recover damaged journal 7=Recover damaged journal receivers 
9=Associate receivers with journal 


ASP 
Opt Journal Library Device Text 
JRNACC DSTA1 JOURNAL FOR ACCOUNTS 


3. Select option 7 (Recover damaged journal receivers). 


Recovering a Journaled Object That Is Damaged or Not 
Synchronized 
For a journaled object that is damaged, do the following: 
1. Find your most recent saved copy of the object. 
2. Delete the object. 
3. Load the save media and restore the object. 
a. For journaled database physical files, or data areas type: 


RSTOBJ OBJ(object-name) OBJTYPE(*object-type) 
SAVLIB(Library-name) 
DEV (media-device-name) 


b. For journaled IFS objects, type: 


RST DEV( 'device-path-name ') 
OBJ ('object-path-name') 
SUBTREE (*ALL) 
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4. Restore any journal receivers that are needed to recover the object, if they are 
not already on the system. 


5. Use the APYJRNCHG command to apply journaled changes. The Journal 
Management topic in the iSeries Information Center 
(http:/ /www.ibm.com/eserver/iseries /infocenter) provides more information 
about applying journaled changes. 


Do the following for a journaled object that could not be synchronized: 
1. Restore the object from your most recent saved copy. 
2. Apply journaled changes to bring the object up to date. 


Note: You may need to perform this procedure for all the objects if there are 
other objects related to the object that is not synchronized. Otherwise, 
the objects may not be synchronized with each other. 


Recovering Damaged Objects in the Integrated File System (IFS) 
To recover damaged objects in the IFS, run the Reclaim Storage (RCLSTG 
command. For more information on the RCLSTG command, refer goer 


Recovering Other Types of Damaged Objects 

Use the following procedure to recover most damaged objects on the system. 
(Table 38 on page 178|shows which types of objects require special procedures. 
1. Find your most recent saved copy of the damaged object. 


Note: If the damaged object is in the QSYS library, you may need to restore the 
operating system. Contact software support for assistance. 


Delete the object. 
Load the save media and restore the object. Type 


RSTOBJ OBJ (object-name) 
OBJTYPE (object-type) 
SAVLIB(library-name) 
DEV (media-device-name) 


on 
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Chapter 8. Recovering Information in a User Auxiliary Storage 
Pool 


When you have user ASPs on your system, you assign specific libraries or objects 
to certain physical disk devices. One reason for having user ASPs is to limit the 
amount of information you need to recover if a DASD device must be replaced. 


The basic process for recovering a user ASP is: 
1. Understand what was in the user ASP. 

2. Choose the correct recovery procedure. 

3. Plan your recovery. 

4. Perform the recovery steps. 


Describing the Contents of Your User Auxiliary Storage Pools 


To choose the correct procedure for recovering the information_on your user ASPs, 
you must understand what they looked like before the failure. igure gl hoes an 
example of a user ASP configuration. This example is used throughout the 
explanations that follow. You may want to begin by drawing a similar picture of 
your configuration. 


System ASP 1 


QSYS Library 
v v v an 
JRNLA 
CUSTLIB ITEMLIB SAVFLIB JRNA 
¥. 
ORDLIB 4 Documents $RCVRB RCVA0003 
> Folders > RCVB0004 *JRNRCV 
(QDOC0003} *JRNRCV 
TRANLIB 4 library) 
“p> ORDSAV 
$JRNLB 4 *SAVF 
JRNB 


User ASP 2 User ASP 3 User ASP 4 User ASP 5 


RBANSS09-0 


Figure 6. User ASP Configuration Before Failure 


In the example: 


* ASP 2 is a library user ASP. It contains these libraries: ORDLIB, TRANLIB, and 
SJRNLB. 


Files in the ORDLIB library and TRANLIB library are journaled to the JRNB 
journal in the $JRNLB library. 


* The journal receivers for the JRNB journal are in the $RCVRB library in ASP 4. 
* ASP 3 is a library user ASP containing documents and folders. 
* ASP 4 is a library user ASP. It contains the $RCVRB library. 
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* ASP 5 is a nonlibrary user ASP. It contains the ORDSAV save file. ORDSAV is in 
the SAVFLIB library, which is in the system ASP. It also contains the RCVA0003 
journal receiver, which is in the $JRNLA library. 


Before the failure, the receiver directory for the JRNA journal looks like this: 


Work with Receiver Directory 
Journal” ees. cat, RNA [EDVARY. cat ee eon :  $JRNLA 
Total size of receivers (in kolobytes)............ : 155648 


Type options, press Enter. 
4=Delete 8=Display attributes 


Attach Save 
Opt Receiver Library Number Date Status Date 
—  RCVAOQ001 $JRNLA Q@0001  06/08/0x SAVED 06/08/9x 
_  RCVA0002 $JRNLA 0002 06/09/0x SAVED 06/09/9x 
L = RCVA0003 $JRNLA 00003 06/09/0x ATTACHED 00/00/00 ) 


Choosing the Procedure to Recover User ASPs 


These basic situations may require you to recover information in a user ASP: 
* You have replaced a disk unit in the system ASP. Although the data is still in 


your user ASPs, you must recover the system’s ability to locate that data 
addressability). This process is described in|“How to Recover a Basic User ASP 
After Recovering the System ASP” 


* You have replaced a disk unit in a basic user ASP. All the information that was 
in the user ASP must be recovered. If this is your situation, follow the procedure 


described in |“How to Recover a Damaged Basic Auxiliary Storage Pool” on 


* You have replaced a disk unit in the system ASP. One of your basic user ASPs 
was in overflowed status. You must recover the addressability to information in 


the user ASPs that were not overflowed by using the procedure described in 
You must 
also recover the information in the user ASP that was overflowed by using the 
procedure described in[’How to Recover a Damaged Basic Auxiliary Storage 

* The service representative has replaced a failed disk unit in an independent 


auxiliary storage pool (ASP). When you lose a disk unit in an ASP, you must 
recover all of the information in that ASP. The information in other ASPs on 


our system is not affected. Follow the procedure described in[“How to Recover] 
an Independent ASP” on page 206 


How to Recover a Basic User ASP After Recovering the System ASP 


Perform this procedure after restoring your Licensed Internal Code and the 
operating system. 


When you replace a unit in your system ASP, the system loses addressability to the 


objects in your basic user ASPs. The system in the example would look like this 
after the operating system has been restored: 
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System ASP 1 


QSYS Library 
ORDLIB <1 || Documents $RCVRB RCVA0003 
b Folders > RCVB0004 *JRNRCV 
(QDOC0003 *JRNRCV 
TRANLIB 4 library) 
> ORDSAV 
$JRNLB 4 SAVF 
JRNB 


User ASP 2 User ASP 3 User ASP 4 User ASP 5 
RBANS510-0 


Figure 7. Basic User ASP Configuration After Restoring Operating System 


The libraries and objects in the basic user ASPs are not known to the system. 


You can use the procedures described in this topic to recover the objects in your 
basic user ASPs. However, the system cannot recover ownership to the objects 
other than document library objects (DLO) in the basic user ASPs because the 
addresses for all user profiles are changed when you restore them. All object types 
except DLOs use the address of the user profile to identify the owner. 


Recovering object ownership for objects other than DLOs requires manually 
assigning ownership for every object in every basic user ASP. 


Task 1—Reclaiming Storage 


1. Sign on the system with a user profile that is authorized to the RCLSTG 
command. Either sign on at the console or use the Transfer Job (TFRJOB) 
command to transfer your job to the controlling subsystem. 

2. Type DSPSYSVAL QALWUSRDMN. If the current value does not include the QRCL 
(Reclaim Storage) library or does not specify *ALL, use the CHGSYSVAL 
command to add QRCL to the list of libraries for this system value. Write the 
current value here: 


3. Type DSPSYSVAL QCTLSBSD to display the name of your controlling subsystem. 
Write the current value here: 


4. Ensure your system is in a restricted state. If it is not, follow the procedure in 
“Putting Your System in a Restricted State” on page 47 


5. Start the reclaim storage process by typing one of the following: 


RCLSTG Reclaim storage of the entire system. 
RCLSTG Reclaim storage of the database cross-reference table. 
SELECT(*DBXREF) 


RCLSTG OMIT(*DBXREF) | Reclaim storage of the entire system except the database 
cross-reference table. 


6. Use the CHGSYSVAL command to set the QALWUSRDMN system value back 
to its original setting. (You wrote the setting in step 2.) 


7. When the reclaim storage procedure finishes, start the controlling subsystem by 
typing the following: 
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STRSBS SBSD(controlling-subsystem) 
(You wrote the name of the controlling subsystem in step 3.) 


After the reclaim storage procedure, the example system looks like this: 


System ASP 1 


QSYS Library 
Vv 
QRCL 
ORDLIB 1 || Documents $RCVRB RCVA0003 
b Folders > RCVB0004 *JRNRCV 
(QDOC0003 *JRNRCV 
TRANLIB 4 library) 
> ORDSAV 
$JRNLB 4 SAVF 
JRNB 


User ASP 2 User ASP 3 User ASP 4 User ASP 5 


RBANS511-0 
Figure 8. User ASP Configuration After Reclaiming Storage 


The system recovers addressability to the objects in ASP 5, but it cannot recover 
their original library assignments. They are placed in the QRCL (Recovery) library. 
The objects in all user ASPs are owned by the QDFTOWN (Default Owner) user 


profile. 


“Reclaiming Storage” on page 48]provides more information about the RCLSTG 


procedure. 


Task 2—Restoring User Profiles 
1. Sign on as QSECOFR. 


2. Ensure the system is in a restricted state. See |“Putting Your System in a| 
Restricted State” on page 4 


3. Find the most recent save media that has your user profiles. It may be a 
SAVSYS media volume or a SAVSECDTA media volume. The file on the save 
media volume is called QFILEUPR. 

4. If you are using a SAVSYS media volume, type: 

RSTUSRPRF DEV(media-device-name) USRPRF(*ALL) 


ENDOPT (*LEAVE) 


If you are using a SAVSECDTA media volume, type: 


RSTUSRPRF DEV(media-device-name) USRPRF(*ALL) 
ENDOPT (*UNLOAD) 


The time that this takes can vary significantly. |“What Happens When You Restore 
User Profiles” on page 223)describes what the system does when you restore user 


profiles. 
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Task 3-Restoring the Configuration 


1. 


Find the most recent save media that has your configuration. It may be a 
SAVSYS media volume or a SAVCFG media volume. The file on the save media 
volume is called QFILEIOC. 


If you are using a SAVSYS media volume, type: 


RSTCFG OBJ(*ALL) DEV (media-device-name) 
OBJTYPE (*ALL) 
ENDOPT (*LEAVE) 


If you are using a SAVCFG media volume, type: 


RSTCFG OBJ(*ALL) DEV(media-device-name) 
OBJTYPE(*ALL) 
ENDOPT (*UNLOAD) 


Task 4—Recovering Journals and Journal Receivers in the 
QRCL Library 


1. 


Determine if any objects are in the QRCL library. Type: DSPLIB QRCL. You see 
the Display Library display. 


. If no objects are listed on the display, skip to |“Task 5—Restoring Libraries to the 
System Auxiliary Storage Pool” on page 190 


If the QRCL library contains objects, save them before proceeding with your 
recovery. Load a scratch media volume. Type the following: 


SAVLIB LIB(QRCL) DEV(media-device-name) 
ENDOPT (*UNLOAD) 


If the ORCL library does not contain journals or journal receivers, skip to[Task] 
5-Restoring Libraries to the System Auxiliary Stora 


Create one or more libraries in the system ASP for the journals and journal 
receivers from the QRCL library. The libraries you create must have the same 
names as the original libraries that contained the journals and journal receivers. 


In the example shown in |Figure 8 on page 188} the QRCL library contains the 


ORDSAV save file and the RCVA0003 journal receiver. At this point you need 
to create the $JRNLA library. You would type: CRTLIB LIB($JRNLA). 

Move the journals and journal receivers to the newly created libraries. This is 
the only circumstance in which you can move journals and journal receivers 
between libraries. You must use the MOVOBJ command. You cannot use save 
and restore commands. The MOVOBJ command leaves the journal or journal 
receiver in the user ASP but establishes its association with the correct library. 


For the example shown in [Figure 8 on page 188} you would type: 


MOVOBJ OBJ(QRCL/RCVAQ003) OBJTYPE(*JRNRCV) TOLIB($JRNLA) 
Delete the QRCL library by typing DLTLIB QRCL. 


Note: If the ORCL library contains save files, you will recover them in [Task] 
9-Recovering Save Files from the QRCL Library” on page 192} When you 


recover them, you will use the media volume that you created in step 


At this point, the system in the example would look like this: 
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System ASP 1 


QSYS Library 
$JRNLA 
Vv 
ORDLIB 4 Documents $RCVRB RCVAO0003 
> Folders > RCVB0004 *JRNRCV 
(QDOC0003 *JRNRCV 
TRANLIB 4 library) 
$JRNLB 4 
JRNB 


User ASP 2 User ASP 3 User ASP 4 User ASP 5 
RBANS512-0 


Figure 9. User ASP Configuration After Recovering Isolated Journal Receiver 


Task 5—Restoring Libraries to the System Auxiliary Storage 
Pool 


1. Decide which libraries to restore. You should restore only the libraries in your 
system ASP. Do not restore the libraries that are already on your system in user 
ASPs. 


If you are not sure which libraries are currently on your system, type DSPOBJD 
OBJ(*ALL) OBJTYPE(*LIB). 


Note: When you install the operating system, the system creates the QGPL 
library and the QUSRSYS library. You should still restore these libraries 
to restore the data from your saved copy. 


2. Plan your restore sequence. If you restore in the wrong sequence, your 
journaling environment may not be started again or some objects may not 
restore successfully. 


For example, journals must be restored before the journaled objects. If journals 
and objects are in the same library, the system restores them in the correct 
order. If they are in different libraries, or the objects are integrated file system 
objects, you must restore them in the correct order. Similarly, physical files 
must be restored before their associated logical files. Read 


Restoring Related Objects” on page 46| for more information. 


3. Choose the commands or menu options you will use. You_can restore libraries 
by name or in a group, such as *NONSYS. See|The Relationship Between Save 
and Restore Commands” on page 43]for more information. 

If you restore libraries in a group, omit the libraries in your user ASPs. 


4. Type the restore commands or menu options that you have chosen. In the 


example shown in|Figure 6 on page 185} libraries were saved using 
SAVLIB(*ALLUSR). One way to restore them would be to type: 


RSTLIB SAVLIB(*ALLUSR) DEV(media-device-name) 
OMITLIB(ORDLIB TRANLIB $JRNLB $RCVRB) 
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, _ If a media error occurs... 


If you have an_unrecoverable media error when you are restoring multiple 
libraries, see|“Recovering from an Error While Restoring Libraries” on 


Task 6—Restoring Document Library Objects to the System 
Auxiliary Storage Pool 


1. Find your most recent save media volume that you used to save all of the 
documents in the system ASP. You may have specified ASP(1) or ASP(*ANY) for 
the save operation. The media volume should have the library QDOC on it. 

2. Use the following command to restore the DLOs: 

RSTDLO DLO(*ALL) FLR(*ANY) ASP(1) 


;— If a media error occurs... 
If you have an unrecoverable media error when you are restoring DLOs, 
see |“Recovering from an Error While Restoring DLOs” on page 59 


Task 7—Restoring User-Defined File Systems to the User 
Auxiliary Storage Pool 
If you are journaling you need to plan your restore sequence. If you restore in the 
wrong sequence, your journaling environment may not be started again or some 
objects may not restore successfully. For example, journals must be restored before 
the journaled objects. If the objects are integrated file system objects, you must 
restore them in the correct order. Read|“Sequence for Restoring Related Objects” on 


page 46] for more information. 


Choose one of the three methods below based on the way in which your 
User-Defined File Systems (UDFS) were saved. 


Recovery Steps for Unmounted User-Defined File Systems 

(UDFS) 

1. Load the media volume with the most recent backup of your UDFS when they 
were unmounted. 

2. To restore a basic ASP, type RST OBJ(('/DEV/QASPxx')) where xx is the 
Auxiliary Storage Pool number. 


Recovery Steps for Mounted User-Defined File Systems (UDFS) if 

Data is not Restored 

Use the following steps if all UDFS are not already restored. The UDFS 

information is not saved or restored if the UDFS were saved mounted. You will 

need to recreate this information in step 1. 

1. Create the UDFS exactly as they were before the recovery by using the 
CRTUDFS command. Be sure to include the authorities and object auditing. 

2. Create the directory that each UDFS was mounted over at the time of the save 
by using the CRTDIR command. 


3. Mount the UDFS over the directory by using the MOUNT command. 
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Note: If you were instructed to refer to these steps from another checklist, 
return to that checklist now. 


4. Restore the UDFS by using the following command: 
RST OBJ(('/directory_mounted_over')) 


Recovery Steps for Mounted User-Defined File Systems (UDFS) if 
Data is Restored 


; Attention! 
This method is not recommended for recovery of UDFS. It is listed only as a 


means of recovery if the data is already restored. The previous method 
“Recovery Steps for Mounted User-Defined File Systems (UDFS) if Data is not 
Restored” on page 191} is the recommended method. 


The UDFS information is not saved or restored if the UDFS were saved mounted. 
You will need to recreate this information in step 1. 


1. Create the UDFS exactly as they were before the recovery by using the 
CRTUDFS command. 


2. Create a temporary directory to use as a mount point, using the CRTDIR 
command. 


3. Mount the UDFS over the temporary directory, using the MOUNT command. 
This now becomes your UDFS in the user ASP. 


4. Create the directories that are currently in the restored mounted UDFS in the 
UDFS that you created in the previous three steps. This tree structure must 
exist in order to move or copy the objects. 


5. Move or copy the objects in the new UDFS, using the MOV or CPY commands. 
6. Unmount the UDFS, using the UNMOUNT command. 


Task 8—-Reclaiming Document Library Objects 


1. If you do not have DLOs in any user ASPs, skip to|Task 9-Recovering Save 
Files from the QRCL Library” 

2. Type: 
RCLDLO DLO(*ALL) ASP(*ANY) 


This procedure rebuilds the association between the DLOs in the user ASP and the 
search index records. It also attempts to assign the DLOs to the correct owner. 


Task 9—Recovering Save Files from the QRCL Library 
If you did not have any save files in the QRCL library, skip to 


1. Load the scratch media volume that you created in|“Task 4—Recovering 
Journals and Journal Receivers in the QRCL Library” on page 189 


5-Restoring Libraries to the System Auxiliary Storag page 190} You 
can check by typing DSPOBJD OBJ (library-name) OBJTYPE(*LIB). 


3. Restore each save file from the scratch media volume to the correct library and 


user ASP. In the example shown in|Figure 6 on page 185} you would type: 
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RSTOBJ OBJ(ORDSAV) SAVLIB(QRCL) 
RSTLIB(SAVFLIB) 
OBJTYPE(*SAVF) RSTASP(5) 


Task 10-—Associating Journal Receivers with Journals 
If you do not have any journals or journal receivers involved in the recovery, skip 
to |“Task 11—Restoring Object Ownership” on page 194 
Whenever you do a recovery involving journals and journal receivers, you should 
ensure that your journal receivers are associated with the journal. This topic 


provides basic information about how to associate your journals and journal 
receivers. 


Based on the steps performed so far, the receiver directory for journal JRNA in the 
example would look like this: 
a >) 


Work with Receiver Directory 


Journal “29.0%. 4.02 JRNA Library ......:  $JRNLA 
Total size of receivers (in kilobytes). ...........3 155648 


Type options, press Enter. 
4=Delete 8=Display attributes 


Attach Save 

Opt Receiver Library Number Date Status Date 
_  RCVAQ003 $JRNLA 00001 06/08/9x ONLINE 00/00/00 
RCVA1002 $JRNLA Q@1001 06/09/9x ATTACHED 00/00/00 


Notice that when JRNA was restored, the system created a new journal receiver 
called RCVA1002 and attached it. The receiver name is based on the name of the 
journal receiver that was attached when the journal was saved. 


Do the following to associate journals and journal receivers: 

1. Type WRKJRN on a command line and press the Enter key. 

2. On the prompt display, type the name of the journal and the library name. 

3. On the Work with Journals display, type a 9 (Associate receivers with journal) 
in the Opt column next to the journal that you want to work with. 

4. Press the Enter key. 


The receivers are reassociated with the journal. 


If any of the journal receivers in the user ASP were created before V3R1, using 
option 9 from the Work with Journals display might not associate them in the 
correct sequence. If you have journal receivers from a prior release or if any of the 
journal receivers you need are not online, do this: 


1. Save the journal receivers that are on the system to a scratch media volume: 


SAVOBJ OBJ(*ALL) LIB(library-name) 
DEV(media-device-name) OBJTYPE(*JRNRCV) 
VOL(*MOUNTED) ENDOPT(*UNLOAD) 


2. After you ensure that the receivers were saved successfully, delete the journal 
receivers from the library: 
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b. 
c. 
d. 


Type WRKLIB library-name and press the Enter key. You are shown the work 
with library display. 

Type a 12 (Work with Objects) in the Opt column. 

Type a 4 (Delete) in the Opt for each journal receiver you want to delete. 
Press the Enter key. 


3. Restore the journal receivers you need from the scratch media volume and 
from your save media volumes. Restore them from newest to oldest by typing 
the following command for each journal receiver: 


RSTOBJ OBJ (receiver-name) 


LIB(library-name) DEV(media-device-name) 
OBJTYPE(*JRNRCV) VOL(*MOUNTED) 
ENDOPT (*UNLOAD) 


The receivers are reassociated with the journal. 


At this point the receiver directory for JRNA looks like this: 


( Work with Receiver Directory » 
Journal ...... 2: 4JRNA Librany® 25. 6 4 -2-.02. “SURNEA 
Total size of receivers (in kilobytes). ........... : 155648 
Type options, press Enter. 

4=Delete 8=Display attributes 
Attach Save 
Opt Receiver Library Number Date Status Date 
—  RCVAQ001 $JRNLA Q0001  06/08/9x SAVED 06/08/9x 
—  RCVA0002 $JRNLA @0002 06/09/9x SAVED 06/09/9x 
—  RCVA0003 $JRNLA 00003 06/08/9x ONLINE 00/00/00 
= RCVA1002 $JRNLA Q@1002 06/09/9x ATTACHED 00/00/00 ) 


Task 11—Restoring Object Ownership 
The RCLSTG procedure assigned_ownership of all the objects in your user ASPs to 
“Task 8—Reclaiming Document Library Objects” on 


he QDFTOWN user profile. In 


t 
lpage 192} you transferred ownership of DLOs to the correct user profiles. To 
transfer ownership of the other objects to the correct user profiles, do the 


following: 
1. Type WRKOBJOWN USRPRF(QDFTOWN) and press the Enter key. 
The Work with Objects by Owner display is shown: 


194 0S/400 Backup and Recovery V5R2 


é . 


Work with Objects by Owner 


User profile 2.23. 2< «3  QDFTOWN 

Type options, press Enter. 

2=Edit authority 4=Delete 5=Display author 
8=Display description 9=Change owner 

Opt Object Library Type Attribute 
9  ORDRCVOO1 JRNLIB *JRNRCV 

9  ORDHDR ORDLIB *FILE 

9  ORDDTL ORDLIB *FILE 

9  ORDHST ORDLIB *FILE 

9  ORDSAV SAVFLIB *SAVF 

9  TRANO1 TRANLIB *FILE 


Parameters or command 

===> NEWOWN(OWNORD) 

F3=Exit F4=Prompt F5=Refresh F9=Retrieve 
F18=Bottom 

SS 


os 


Note: If you see document library objects on this list (type *DOC or *FLR), one 
of the following has occurred: 


* You forgot to run RCLDLO. See |Task 8—Reclaiming Document Library 
Objects” on page 192 


* The user profile that owns the DLO has not been restored. Restore the 
user profile. Then run the RCLDLO command. 


* The DLO was owned by the QDFTOWN profile when it was saved. 
Determine the correct owner for the DLO and transfer ownership. 


2. To transfer ownership of objects individually: 


a. Type a 9 in the Opt column for the object and press the Enter key. The 
Change Object Owner display is shown. 


b. Type the name of the correct owner in the New owner prompt and press the 
Enter key. 


c. Repeat steps |2aland [2b] for each object on the display. 


3. To transfer ownership of multiple objects that should have the same owner, use 
the technique shown in the display: 


a. Type 9 in the Opt column. 

b. Type NEWOWN(owner-name) on the parameter line at the bottom of the 
display. 

c. Press the Enter key. The system transfers ownership of each object you 
specified to the new owner. 


;_ Stop! 
You have completed the recovery of information in your user auxiliary 
storage pools. Consult your recovery checklist for the next step in your 
recovery process. 


How to Recover An Overflowed User Auxiliary Storage Pool 
The topics in this section provide basic information about working with user ASPs 
in recovery situations. |Chapter 20} “Working with Auxiliary Storage Pools”, 
provides more information about setting up and managing user ASPs. 
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When the disk units allocated to a user ASP become full, the user ASP is in 
overflowed status. The system sends message CPI0953 to the QSYSOPR message 
queue warning you that an ASP is approaching its storage threshold. The system 
sends message CPI0954 when the storage threshold has been exceeded and the 
ASP is in overflowed status. 


You should reset a user ASP in overflowed status as soon as possible. An 
overflowed ASP affects system performance. It also makes recovery more difficult 


and_may increase the amount of data lost if a failure occurs. Follow the procedure 

in |“Resetting An Overflowed User Auxiliary Storage Pool without an IPL” 

Note: To simplify future overflow recovery operations, you can enable automatic 
overflow recovery for basic user ASPs with the iSeries Navigator disk 


management function. For more information, refer to the Information Center 
at http://www.ibm.com/eserver/iseries/infocenter. 


Resetting An Overflowed User Auxiliary Storage Pool without 
an IPL 


Do the following to reset a user ASP in overflowed status: 
1. Determine which objects in the ASP have overflowed. Use one of these 
methods: 
* Use the DSPOBJD command to create an output file. Then run a query 
against that output file: 
a. For the first library in the user ASP, type: 


DSPOBJD OBJ(Library-name/*ALL) OBJTYPE(*ALL) 
DETAIL(*FULL) OUTPUT (*OUTFILE) 
OUTFILE(library-name/file-name) 


b. For each additional library in the user ASP, type: 


DSPOBJD OBJ (Library-name/*ALL) OBJTYPE(*ALL) 
DETAIL(*FULL) OUTPUT (*OUTFILE) 
OUTFILE(library-name/file-name) 
OUTMBR(*FIRST *ADD) 


c. Create a query against the output file. Look for objects that have a 1 (Yes) 
in the ODOASP (overflowed ASP) field. 


* For a user ASP that contains only DLOs, use the QRYDOCLIB command. It 
has a parameter to display overflowed DLOs. 


2. Save each overflowed object to a scratch media volume. 
3. Delete each overflowed object. 


Some objects, such as journals and physical files, require that you take certain 
actions before deleting them. [Table 39} shows what to do before deleting these 
objects. 


Table 39. Object Types That Require Special Procedures for Deleting 


Object Type Do This Before Deleting 
Journal “Steps before Deleting a Journal” on page 257 


“Steps before Deleting a Journal Receiver” on page 259 
“Steps Before Deleting a Physical File” on page 255 


4. Ensure that the ASP is no longer in overflowed status. You should have 
received a message in the QSYSOPR message queue that the overflow 
condition has been recovered. You can also use System Service Tools (SST) to 
check: 


Journal receiver 
Physical file 
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a. Type STRSST. You are shown the System Service Tools (SST) menu. 
b. Select the option to work with disk units. 
c. Select the option to display disk configuration. 
d. Select the option to display disk configuration capacity. You are shown the 
Display Disk Configuration Capacity display: 
This display shows whether any ASPs are in overflowed status. 
a ; >) 
Display Disk Configuration Capacity 
--Protected-- --Unprotected-- 
ASP Unit Type Model Threshold Overflow Size %Used Size %Used 
1 90% No 0 0.00% 1400 8.22% 
1 9332 400 08 0.00% 200 = 17.97% 
2 9332 400 08 0.00% 200 §=6.60% 
2 Yes 08 0.00% 200 + =—99.99% 
8 9332 200 90% 08 0.00% 200 + =99.99% 
= y 


If the user ASP is still overflowed, follow the procedure described in[’Resetting] 
An Overflowed User Auxiliary Storage Pool during an IPL” 
5. Before you can restore the overflowed objects from a media volume, you must 


make additional space available in the user ASP. Do one or more of the 
following: 


Delete objects from the ASP if you no longer need them. 
Move one or more libraries to a different ASP. 


Note: You cannot use the MOVOBJ command to do this. You must save the 
library, delete it, and restore it to a different ASP. 


Move one or more folders to a different ASP by saving the folder, deleting it, 
and restoring it to a different ASP. 


Add additional disk units to the ASP. 


6. After you have made additional space available in the ASP, restore the objects 


you saved in step}2 on page 196 
7. Check to make sure the user ASP has sufficient space and is not overflowed. 
Repeat the procedure described in step|4 on page 196 


Resetting An Overflowed User Auxiliary Storage Pool during 


an IPL 


Sometimes you are not able to find all the overflowed objects in a user ASP. If you 


have taken the steps described in|Resetting An Overflowed User Auxiliary 


orage Pool without an IPL” on page 196}and the user ASP is still overflowed, you 
can perform a manual IPL to reset the user ASP. Do the following: 


1. Ensure that you have enough space to reset the overflowed user ASP. Do the 
following: 


a. 


Type STRSST. You are shown the System Service Tools (SST) menu. 


b. Select the option to work with disk units. 
Cc. 
d 


Select the option to display disk configuration. 


. Select the option to display disk configuration capacity. You are shown the 


Display Disk Configuration Capacity display: 
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(e -* 


Display Disk Configuration Capacity 
--Protected-- --Unprotected-- 
ASP Unit Type Model Threshold Overflow Size %Used Size %Used 
1 90% No 0 0.00% 1400 8.22% 
1 9332 400 0 0.00% 200 17.97% 
2 9332 400 0 0.00% 200 §=6.60% 
2 Yes 0 0.00% 200 99.99% 
8 9332 200 90% 0 0.00% 200 99.99% 


This display shows whether any ASPs are in overflowed status. 


e. Press F9 (Display ASP Overflow information) to display the overflow 
amount and the additional amount of storage that is needed in the ASP to 
recover the overflowed objects. 


Display ASP Overflow Information 


Overflow ----Amount Needed to Recover---- ASP Threshold Amount 
To Capacity To Threshold 

2 90% 14 0 0 

3 90% 25 25 45 


f. If the amount in the To Capacity field is greater than zero, the ASP will still 
be overflowed when the recovery completes. There is not enough free space 
in the user ASP to contain the overflowed data. 


g. If you do not have enough space, repeat the instructions in step 
page 17 


age 197|to free more space. 
2. Do the following to put your system in a restricted state: 


a. Before putting your system in a restricted state, ensure that all users are 
signed off and all jobs are ended. 


b. To receive notification that the subsystems have ended, type the following 
and press the Enter key: 


CHGMSGQ MSGQ(QSYSOPR) DLVRY (*BREAK) 
SEV (60) 


c. To end all subsystems, type the following: 


ENDSBS SBS(*ALL) OPTION(*CNTRLD) 
DELAY (600) 


Note: For the delay parameter, specify a number of seconds that allows 
your system time to bring most jobs to a normal end. On a large, 
busy system, you may need a longer delay. 


A message is sent that indicates that the procedure for ending subsystems is in 
progress. A final message is sent when the system is in a restricted state. 


3. Perform a manual IPL and access DST: 


Use this procedure to start_DST. If the IPL or Install the System menu is already 
displayed, start with step |5 on page 210 


a. Ensure the keystick is in the system unit control panel. 
b. Place the system in manual mode. 
c. Power down the system: 


PWRDWNSYS OPTION(*CNTRLD) DELAY (600) 
RESTART(*YES) IPLSRC(B) 
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;— Attention logical partitioning users! 
If you are going to use this command on the primary partition, be sure 
to power off all secondary partitions before running the command. 


Note: If you are sure that no jobs are running on your system, you can 
specify OPTION(*IMMED) when you power down the system. 
Otherwise, specify a delay time that is sufficient to allow jobs to end 
normally. 


d. When the IPL completes, the IPL or Install the System menu appears. 


IPL or Install the System 


Select one of the following: 

Perform an IPL 

Install the operating system 

Use Dedicated Service Tools (DST) 

Perform automatic installation of the operating system 
Save Licensed Internal Code 


orwNnr 


4. Select option 1 (Perform an IPL). You are shown the Disk Configuration 
Attention Report: 


(~ Disk Configuration Attention Report ) 


Type option, press Enter. 

5=Display Detailed Report 
Press F10 to accept all the following problems and continue. 
The system will attempt to correct them. 


Opt Problem 
Overflowed ASPs 


y 


If you type 5 in the Option field, the following screen is displayed, listing the 
User ASPs that are overflowed. 


( Recover Overflowed User ASP > 


The following user ASPs are overflowed. 


ASP 


5. Press the F10 key to request recovery of the overflowed user ASPs. The 
recovery takes place during the storage management recovery phase of the IPL. 
The operation takes from several minutes to a few hours, depending on the 
number of objects on the system and the amount of data to be recovered. 

6. When the IPL of the system is complete, the Sign On display is shown. 

7. Sign on and verify the results by checking the messages in the QSYSOPR 
message queue. 
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How to Delete Overflowed Objects during Recovery 


Use this procedure if you are recovering a user ASP that was in overflowed status. 

1. After running the RCLSTG procedure, display the contents of the QRCL library 
by typing: DSPLIB QRCL 

2. Write down the names of the objects in the library. These objects were 
overflowed into the system ASP at the time of the failure. 
Although the initial disk extents for these objects may have been allocated in 
the system ASP, portions of the objects may still have been lost. The integrity of 
these objects cannot be predicted. They should be deleted and recovered. 


3. Delete the overflowed objects. You must take special action before deleting 
certain types of objects. See|/Table 39 on page 196|for more information. 

4. When you run the RCLSTG command, any documents from the lost user ASP 
that were in overflowed status are placed in the user ASP again. (The system 
creates a new QDOCnnnn library, where nnnn is the number of the lost ASP, 
and places the overflowed DLOs in it.) 

Assuming you have not yet restored DLOs to the user ASP, type this to delete 
the overflowed DLOs: 


DLTDLO DLO(*ALL) FLR(*ANY) ASP(n) 


where 1 is the number of the ASP whose data was lost. 


How to Recover a Damaged Basic Auxiliary Storage Pool 


Perform this procedure if one of the following is true: 


* The service representative has replaced a failed disk unit in a basic user ASP. If a 
disk unit is not parity protected or mirrored, when you lose that disk unit in an 
ASP, you must recover all of the information in that ASP. The information in 
other ASPs on your system is not affected. 


* The system has reassigned sectors on a disk unit, but object damage has 
occurred. 


* You have replaced a disk unit in the system ASP and one or more user ASPs 
was overflowed. 


Task 1—Restoring User Profiles 


Even though user profiles are not lost when you replace a unit in a user ASP, they 
must be restored to prepare for restoring authority to objects in the user ASP. Do 
the following: 


1. Sign on with the QSECOFR user profile. 

2. End all subsystems with the ENDSBS command and go to a restricted state. 
3. Load your most recent SAVSYS or SAVSECDTA media volume. 

4. Restore all user profiles. Type: 


RSTUSRPRF DEV(media-device-name) USRPRF(*ALL) 
ENDOPT (*UNLOAD) 


5. If you know what libraries or objects were in the user ASP that was lost, skip 


to|“Task 3-Determining Tasks to Restore Objects” on page 201 


If you do not know what was in the user ASP, continue with 


2-Determining the Contents of the Lost Auxiliary Storage Pool” on page 201 
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Task 2—Determining the Contents of the Lost Auxiliary Storage 


If your system has a small number of libraries and is well-documented, like the 
one iniFigzire 6 on, page 1851 your task is relatively simple. In the example, if a disk 
unit in ASP 2 is replaced, the user must recover the ORDLIB, TRANLIB, and 
$JRNLB libraries. If a disk unit in ASP 5 is replaced, the user must recover all the 
journal receivers in the $JRNLA library and the ORDSAV save file in the SAVFLIB 
library. 


Pool 


If you are not sure what was on the basic ASP, do this: 


1: 


2. 


3. 


4. 


Sign on with a user profile that has *ALLOBJ special authority so that your 
listings show all libraries. 


Print a list of the libraries that are on the lost basic ASP by doing the following: 
a. Create a list of all the libraries in an output file: 


DSPOBJD OBJ(QSYS/*ALL) OBJTYPE(*LIB) OUTPUT (*PRINT) 
DETAIL(*FULL) OUTPUT(*OUTFILE) 
OUTFILE(library-name/file-name) 
b. Use a program or a query tool to display or print the output file. Select all 
entries that have an ASP field that matches the ASP that is lost. 


Notes: 


1) When you lose a basic ASP, you lose the contents of any libraries in the 
ASP, not the libraries themselves. The library objects are in the QSYS 
library, which is in the system ASP. 


2) If you had documents in the basic ASP, you should have a library on 
your listing for the ASP. The library name is QDOCnnnn, where nnn is 
the number of the ASP. 


If you have determined what must be recovered, continue with[’Task| 
3-Determining Tasks to Restore Objects”} If you have not found any libraries to 
recover, continue with step 


If you did not find any libraries to recover in step [2] the ASP was probably a 
nonlibrary user ASP. A nonlibrary user ASP can contain only save files, 
journals, and journal receivers. 


Determining the objects that were in a nonlibrary user ASP can be very time 
consuming. The following steps are one method. This method works only if 
you have not yet run RCLSTG after losing the user ASP. 


a. Type the following: 


DSPOBJD OBJ(*ALL/*ALL) 
OBJTYPE(*LIB *FILE *JRN *JRNRCV) 
OUTPUT (*OUTFILE) 
OUTFILE(library-name/file-name) 


b. Use a program or query tool to list all the objects in the output file that are 
in the ASP that is damaged. 


When you have determined the objects that need to be recovered, continue 
with|“Task 3—Determining Tasks to Restore Objects” 


Task 3—Determining Tasks to Restore Objects 


1. 


2. 


Use [Table 40 on page 202|to determine how to recover the objects in your basic 


ASP. It shows the recovery tasks you must perform, based on the contents of 
the basic ASP you are recovering. 


If you have different types of objects to recover, such as libraries and 
documents, perform the tasks in the order shown in the table. 
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Table 40. Tasks for Restoring basic ASP Objects 


Type of ASP Contents Recovery Tasks 


Libraries to a Basic Auxiliar 


“Task 4—Restoring 
“Task 5—Restoring 

torage Pool” 
“Task 6—Restoring Documents to a Basic Auxiliar 
torage Pool” on page 204 
“Task 7—-Restoring User-Defined File Systems to ai 


Library User ASP Libraries 


Nonlibrary User Journals Journals to a Basic Auxiliar 
ASP 


Library User ASP Documents 


WwW 


Library User ASP User-defined file 


systems Basic Auxiliary Storage Pool” on page 204 
Nonlibrary User Journal receivers g 
ASP Auxiliary Storage Pool” on page 205 
Nonlibrary User Save files 
ASP Storage Pool” on page 205 


Task 4—Restoring Libraries to a Basic Auxiliary Storage Pool 
1. Sign on with a user profile that has *SAVSYS and *JOBCTL special authority. 
2. For each library you need to recover, load the correct volume from your latest 
save media volumes. 
3. Type: 


RSTLIB SAVLIB(library-name) DEV(media-device-name) 
ENDOPT (*LEAVE) 


Note: You should restore changed objects and apply journaled changes for all 
the ASPs included in your recovery at the same time. These steps appear 
on the recovery checklist at the appropriate point. 


4. Continue with the next task shown in|Table 40) If you have completed all the 
appropriate tasks in the table, continue with the next task in the recovery 


checklist from 


Task 5—Restoring Journals to a Basic Auxiliary Storage Pool 
1. Sign on with a user profile that has *SAVSYS and *JOBCTL special authority. 
2. For each journal you need to recover, load the correct save media volume and 
type: 


RSTOBJ OBJ(journal-name) SAVLIB(library-name) 
DEV(media-device-name) OBJTYPE(*JRN) 


When you restore the journal, the system automatically creates and attaches a 
new journal receiver. The Journal Management topic in the iSeries Information 
Center (http://www.ibm.com/eserver/iseries/infocenter) describes how the 
system names the journal receiver that is created when you restore a journal. 
3. Establish your journaling environment again. Do this: 

a. For each database physical file that was journaled to the restored journal, 

type: 

STRJRNPF FILE(library-name/file-name) 

JRN(library-name/journal-name) 


Note: To determine what options you specified for the file when you last 
journaled it, you can use the Display File Description (DSPFD) or 
Display Object Description (DSPOBJD) commands for the file to find 
out. 
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b. For each access path that was journaled to the restored journal, type: 
STRJRNAP FILE(library-name/file-name) 
JRN(Library-name/journal-name) 
c. For each IFS object that was journaled to the restored journal, type: 


STRJRN OBJ (‘object-path-name') 
JRN(‘journal-path-name') 


Note: To determine what options you specified for the object when you last 
journaled it, you can use the Display Link (DSPLNK) command. 


d. For all other object types that were journaled, type one of the following: 


STRJRNOBJ OBJ (library-name/object-name) 
OBJTYPE (object-type) 
JRN(library-name/journal-name) 


Note: To determine what options you specified for the object when you last 
journaled it, you can use the Display Object Description (DSPOBJD) 
command. 


e. Save each object that you started ene 


5. Associate journal receivers with the journals you sestored. Do the following: 
a. Type WRKJRN on a command line and press the Enter key. 
b. On the prompt display, type the name of the journal and the library name. 
c. On the Work with Journals display, type a 9 (Associate receivers with 
journal) in the Opt column next to the journal that you want to work with. 
d. Press the Enter key. 
The receivers are reassociated with the journal. 


If any of the journal receivers in the user ASP were created before V3R1, using 
option 9 from the Work with Journals display might not associate them in the 
correct sequence. If you have journal receivers from a prior release or if any of 
the journal receivers you need are not online, do this: 

a. Save the journal receivers that are on the system to a scratch media volume: 


SAVOBJ OBJ(*ALL) LIB(library-name) 
DEV(media-device-name) OBJTYPE(*JRNRCV) 
VOL(*MOUNTED) ENDOPT(*UNLOAD) 


b. After you ensure that the receivers were saved successfully, delete the 
journal receivers from the library: 
1) Type WRKLIB library-name and press the Enter key. You are shown the 

work with library display. 

2) Type a 12 (Work with Objects) in the Opt column. 
3) Type a 4 (Delete) in the Opt for each journal receiver you want to delete. 
4) Press the Enter key. 

c. Restore the journal receivers that you need from both the scratch media 


volume and from your save media volumes. Restore them from newest to 
oldest by typing the following command for each journal receiver: 


RSTOBJ OBJ (receiver-name) 
LIB(Library-name) DEV(media-device-name) 
OBJTYPE(*JRNRCV) VOL(*MOUNTED) 
ENDOPT (*UNLOAD) 


The receivers are reassociated with the journal. 
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6. Continue with the next task shown in|Table 40 on page 202] If you have 


completed all the appropriate tasks in the table, continue with the next task in 


the recovery checklist from {Chapter 4 


Task 6—Restoring Documents to a Basic Auxiliary Storage 
Pool 
1. Sign on with a user profile that has *SAVSYS and *JOBCTL special authority. 
2. Load the media volume with your last complete save of documents in the user 
ASP. 
3. Restore the documents to the user ASP by typing: 


RSTDLO DLO(*ALL) SAVASP(ASP-number) 
RSTASP (ASP-number) 


This restores the documents and makes any changes necessary to the search 
index database files. 


4. Use the Query Document Library (QRYDOCLIB) to locate any documents that 
were created on the user ASP since the last save operation. Query by ASP 
number and creation date. Inform your users that these documents were lost 
and develop a plan to re-create them. 


5. Continue with the next task in the recovery checklist from |Chapter 4 


Task 7—Restoring User-Defined File Systems to a Basic 
Auxiliary Storage Pool 


Choose one of the three methods below based on the way in which your 
User-Defined File Systems (UDFS) were saved. 


Recovery Steps for Unmounted User-Defined File Systems 

(UDFS) 

1. Load the media volume with the most recent backup of your UDFS when they 
were unmounted. 


2. To restore a basic ASP, type RST OBJ(('/DEV/QASPxx')) where xx is the auxiliary 
storage pool number. 


Recovery Steps for Mounted User-Defined File Systems (UDFS) if 
Data is not Restored 

Use the following steps if all UDFS are not already restored. The UDFS 
information is not saved or restored if the UDFS were saved mounted. You will 
need to recreate this information in step 1. 


1. Create the UDFS exactly as they were before the recovery by using the 
CRTUDFS command. Be sure to include the authorities and object auditing. 


2. Create the directory that each UDFS was mounted over at the time of the save 
by using the CRTDIR command. 


3. Mount the UDFS over the directory by using the MOUNT command. 


Note: If you were instructed to refer to these steps from another checklist, 
return to that checklist now. 


4. Restore the UDFS by using the following command: 
RST OBJ(('/directory_mounted_over')) 
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Recovery Steps for Mounted User-Defined File Systems (UDFS) if 
Data is Restored 


;_ Attention! 
This method is not recommended for recovery of UDFS. It is listed only as a 


means of recovery if the data is already restored. The previous method 
“Recovery Steps for Mounted User-Defined File Systems (UDFS) if Data is not 
Restored” on page 191} is the recommended method. 


The UDFS information is not saved or restored if the UDFS were saved mounted. 
You will need to recreate this information in step 1. 


1. 


5: 
6. 


Create the UDFS exactly as they were before the recovery by using the 
CRTUDFS command. 

Create a temporary directory to use as a mount point, using the CRTDIR 
command. 

Mount the UDFS over the temporary directory, using the MOUNT command. 
This now becomes your UDFS in the user ASP. 

Create the directories that are currently in the restored mounted UDFS in the 
UDFS that you created in the previous three steps. This tree structure must 
exist in order to move or copy the objects. 

Move or copy the objects in the new UDFS, using the MOV or CPY commands. 


Unmount the UDFS, using the UNMOUNT command. 


Task 8—Restoring Journal Receivers to a Basic Auxiliary 
Storage Pool 


1. 
2. 


Sign on with a user profile that has *SAVSYS and *JOBCTL special authority. 


For each journal receiver you need to recover, load the correct save media 
volume and type: 


RSTOBJ OBJ(receiver-name) SAVLIB(library-name) 
DEV(media-device-name) OBJTYPE(*JRNRCV) 


Note: For journal receivers created before V3R1, restore the journal receivers 
from newest to oldest to ensure that they are associated with the journal 
in the correct sequence. If all the journal receivers were created on V3R1 
or later, you can restore them in any sequence. 


Continue with the next task shown in|Table 40 on page 202] If you have 


completed all the appropriate tasks in the table, continue with the next task in 
the recovery checklist from 


Task 9-Restore Save Files to a Basic Auxiliary Storage Pool 


Te 


Sign on with a user profile that has *SAVSYS and *JOBCTL special authority. 


2. For each save file you need to recover, load the correct save media volume and 


type: 
RSTOBJ OBJ(save-file-name) SAVLIB(library-name) 
DEV(media-device-name) OBJTYPE(*SAVF) 


Note: This command restores the description of the save file and its contents, if 
you specified SAVFDTA(*YES) when you saved the save file. If you 
specified SAVFDTA(*NO) when you saved the save file, this command 
restores only the save file description. 


3. Continue with the next task in the recovery checklist from |Chapter 4 


Chapter 8. Recovering Information in a User Auxiliary Storage Pool 205 


How to Recover an Independent ASP 


Perform this procedure if one of the following is true: 

* The service representative has replaced a failed disk unit in an independent 
auxiliary storage pool (ASP). If a disk unit is not parity protected or mirrored, 
when you lose that disk unit in an ASP, you must recover all of the information 
in that ASP. The information in other ASPs on your system is not affected. 

* The system has reassigned sectors on a disk unit, but object damage has 
occurred. 


* You are performing a full system recovery and have been directed to this 
procedure from a recovery checklist. 


The independent ASP that you recover must be in the Available state to perform 
the restore. 


Note: Independent ASPs are called independent disk pools in iSeries Navigator. 


Task 1—Restoring User Profiles 
Even though user profiles are not lost when you replace a unit in an independent 
ASP, they must be restored to prepare for restoring authority to objects in the 
independent ASP. 


Note: If you are performing a full system recovery and chose not to perform a 
RSTAUT command before the IPL, or if you chose to only restore authorities 
for the system and basic ASPs, you can skip this step. 

Sign on with the QSECOFR user profile. 

End all subsystems with the ENDSBS command and go to a restricted state. 

Load your most recent SAVSYS or SAVSECDTA media volume. 

Restore all user profiles. Type: 

RSTUSRPRF DEV(media-device-name) USRPRF(*ALL) 


ENDOPT(*UNLOAD) SECDTA(*PVTAUT) 
“Task 4—Restoring User-Defined File 


If you are restoring a UDFS ASP, skip to 


Systems to the Independent Auxiliary Storage Pool” on page 208 


Task 2—Determining Tasks to Restore Objects to an 
Independent ASP 


If you are performing a full system recovery, you need to perform this task for 
each independent ASP. Your restore process will be most efficient if you restore 
independent ASPs and their contents in the order that they were saved. 
Independent ASPs are saved alphabetically. Secondary ASPs are saved along with 
their primary. 


Pon > 


Table 41. Example of restore order for independent ASPs saved with GO SAVE: Option 21 


or 23 

Restore | Independent ASP | Independent ASP | What is restored |Command 

order name type 

1 Apples Primary Libraries RSTLIB SAVLIB 
Cantaloupe Secondary Canties) 

2 Apples Primary User-defined file RST OBJ((‘/ DEV/ 
Cantaloupe Secondary Bystemie tape) 
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Table 41. Example of restore order for independent ASPs saved with GO SAVE: Option 21 
or 23 (continued) 


Restore | Independent ASP | Independent ASP | What is restored | Command 
order name type 


3 Bananas UDFS User-defined file RST OBJ((‘/DEV/ 
systems iasp-name’)) 


1. Use |Table 42} to determine how to recover the objects in your independent ASP. 
It shows the recovery tasks you must perform, based on the contents of the 
independent ASP you are recovering. 


2. If you have different types of objects to recover, such as libraries and 
documents, perform the tasks in the order shown in the table. 


Table 42. Tasks for Restoring independent ASP Objects 


Contents Recovery Tasks 
Libraries “Task 3-Restoring Libraries to the Independent Auxiliary Storage 


User-defined file 
systems 


“Task 4—Restoring User-Defined File Systems to the Independent 
Auxiliary Storage Pool” on page 208 


Task 3-Restoring Libraries to the Independent Auxiliary 
Storage Pool 


1. Sign on with a user profile that has *SAVSYS and *JOBCTL special authority. 
2. For each ASP group, type: 
SETASPGRP (i asp-group-name) 


3. To recover libraries within the independent ASP group, load the correct volume 
from your latest save media volumes. Make sure you are at the correct spot in 
the save media. You may need to specify a sequence number to access the 
correct library data for your independent ASP. 


* To restore libraries that were saved by a GO SAVE: Option 21 or 23 
command, type: 
RSTLIB SAVLIB(*ALLUSR) DEV(media-device-name) 
ENDOPT (*LEAVE) 
* To restore an individual library to the independent ASP, type: 


RSTLIB SAVLIB(library-name) DEV (media-device-name) 
ENDOPT (*LEAVE) 


The default for the RSTLIB command is to restore the library to the 
independent ASP from which it was saved. If you want to restore the library to 
another independent ASP, you can use the RSTASPDEV parameter. If you want 
to restore the library to a basic ASP or the system ASP instead of the 
independent ASP you can use the RSTASP parameter. It is possible to restore 
the same library to two different independent ASPs. However, you cannot 
restore the same library to an independent ASP as well as the system ASP or 
basic ASP. 


Note: You should restore changed objects and apply journaled changes for all 


the ASPs included in your recovery at the same time. These steps appear 
on the recovery checklist at the appropriate point. 
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4. Continue with the next task shown in|Table 42 on page 207] If you have 


completed all the appropriate tasks in the table, continue with the next task in 


the recovery checklist from {Chapter 4 


Task 4—Restoring User-Defined File Systems to the 
Independent Auxiliary Storage Pool 


Choose one of the three methods below based on the way in which your 
User-Defined File Systems (UDFS) were saved. 


Recovery Steps for Unmounted User-Defined File Systems 

(UDFS) 

1. Load the media volume with the most recent backup of your UDFS when they 
were unmounted. 

2. Unmount any QDEFAULT user-defined file systems in the independent ASP. 

3. To restore the UDFS into an independent ASP, type RST 0BJ(('/DEV/iasp- 
name')) where iasp-name is the name of the independent ASP. If you are 
restoring multiple independent ASPs in the order you saved them, you can also 
specify RST 0BJ(('/DEV/*')) to restore all user-defined file systems for each 
independent ASP. 

4. Mount any QDEFAULT user-defined file systems that were unmounted in an 
earlier step. 


Recovery Steps for Mounted User-Defined File Systems (UDFS) if 

Data is not Restored 

Use the following steps if all UDFS are not already restored. The UDFS 

information is not saved or restored if the UDFS were saved mounted. You will 

need to recreate this information in step 1. 

1. Create the UDFS exactly as they were before the recovery by using the 
CRTUDFS command. Be sure to include the authorities and object auditing. 

2. Create the directory that each UDFS was mounted over at the time of the save 
by using the CRTDIR command. 


3. Mount the UDFS over the directory by using the MOUNT command. 


Note: If you were instructed to refer to these steps from another checklist, 
return to that checklist now. 


4. Restore the UDFS by using the following command: 
RST OBJ(('/directory_mounted_over')) 


Recovery Steps for Mounted User-Defined File Systems (UDFS) if 
Data is Restored 


; Attention! 
This method is not recommended for recovery of UDFS. It is listed only as a 


means of recovery if the data is already restored. The previous method 
“Recovery Steps for Mounted User-Defined File Systems (UDFS) if Data is not 
Restored” on page 191} is the recommended method. 


The UDFS information is not saved or restored if the UDFS were saved mounted. 
You will need to recreate this information in step 1. 


1. Create the UDFS exactly as they were before the recovery by using the 
CRTUDFS command. 
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2. Create a temporary directory to use as a mount point, using the CRTDIR 
command. 


3. Mount the UDFS over the temporary directory, using the MOUNT command. 
This now becomes your UDFS in the user ASP. 


4. Create the directories that are currently in the restored mounted UDFS in the 
UDFS that you created in the previous three steps. This tree structure must 
exist in order to move or copy the objects. 

5. Move or copy the objects in the new UDFS, using the MOV or CPY commands. 


6. Unmount the UDFS, using the UNMOUNT command. 


How to Remove a Failed Disk Unit from the System ASP 


Use this procedure to remove a disk unit from your configuration if the unit has 
failed. This procedure allows you to return your system to operation if a 
replacement disk unit is not immediately available. However, this procedure 
removes all data from your system and requires a complete restore operation. 


After performing this procedure, your system will have less disk capacity. You may 
not be able to restore all user information until you have installed and configured 
a replacement disk unit. 


Before you perform this procedure, ensure that the remaining 2800-001 storage 
units in your system ASP are large enough for a main storage dump. Consult 


software support or refer to|Chapter 20, “Working with Auxiliary Storage Pools” onl 


Task 1—Access Dedicated Service Tools 


Use this procedure to start DST. If the IPL or Install the System menu is already 


displayed, start with step|5 on page 210 
1. Ensure the keystick is in the system unit control panel. 


2. Place the system in manual mode. 
3. Power down the system: 


PWRDWNSYS OPTION(*CNTRLD) DELAY(600) RESTART(*YES) 
IPLSRC(B) 


;— Attention logical partitioning users! 
If you are going to use this command on the primary partition, be sure to 
power off all secondary partitions before running the command. 


Note: If you are sure that no jobs are running on your system, you can specify 
OPTION(*IMMED) when you power down the system. Otherwise, specify a 
delay time that is sufficient to allow jobs to end normally. 


4. When the IPL completes, the IPL or Install the System menu appears. 
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IPL or Install the System 


Select one of the following: 

Perform an IPL 

Install the operating system 

Use Dedicated Service Tools (DST) 

Perform automatic installation of the operating system 
Save Licensed Internal Code 


arwWwNnNr 


5. Select option 3 (Use Dedicated Service Tools (DST)) and press the Enter key. 
The Dedicated Service Tools (DST) Sign On display is shown. 


Dedicated Service Tools (DST) Sign On 

Type choice, press Enter. 
DIS eS ake Sartac Cera eri rreeenrie 
DSTipasswondi = 4) 6 ens 


6. In the DST user field, type QSECOFR. In the DST password field, type your DST 
security-level or full-level password. On a new system, the password is 
QSECOER. The password is case sensitive; type in all capital letters. You should 
change this password after you complete your installation procedures. The 
iSeries Security Reference book has more information about DST passwords. 


The Use Dedicated Service Tools (DST) menu is shown. 


Use Dedicated Service Tools (DST) 
Select one of the following: 
Perform an IPL 
Install the operating system 
Work with licensed internal code 
Work with disk units 
Work with DST environment 
. Select DST console mode 
. Start a service tool 
. Perform automatic installation of the operating system 
. Work with save storage and restore storage 


. Work with remote DST support 
S / 


SGSoOOntanfWNre 


Re 


Task 2-Delete the Auxiliary Storage Pool Data 
1. From the Use Dedicated Service Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 
b. Select option 1 (Work with disk configuration) on the Work with Disk 
Units display. 
c. Select option 3 (Work with ASP configuration) on the Work with Disk 
Configuration display. 
2. Select option 4 (Delete ASP data) on the Work with ASP Configuration display. 


Note: Selecting this option deletes all data in the system ASP. Do not use this 


procedure unless you have a failed disk unit and there is no immediate 
replacement for the disk unit. 
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a > 


Select ASP to Delete Data From 
Type options, press Enter 

4=Delete ASP data 
Option 
ASP Threshold Overflow --Protected-- --Unprotected 

Size %Used Size %Used 
1 90% No 0.00 0.00% 1200 74.84% 
2 90% Yes 0.00 0.00% 200 99.99% 
3 90% Yes 0.00 0.00% 200 99.99% 

Ne S 


3. Type a 4 in the Option column to select the ASP that you want to delete the 
data from and press the Enter key. The following display is shown. 


ie =~ 
Confirm Delete ASP Data 
Warning: All data will be deleted from the selected ASPs. 
You have selected to delete data from ASP 1. This will prevent 
you from changing the disk configuration in some ways until 
the system is IPLed again to DST. 


Press F10 to confirm your choice for 4=Delete ASP data. 
Press F1l2=Cancel to return to change your choice. 


--Protected-- --Unprotected-- 
Option ASP Threshold Overflow Size %Used Size %Used 
4 1 90% No 0 0.00 1200 * 
8 / 


4. Press F10 (Confirm) to confirm your choice to delete the ASP data. 


5. When the delete of the ASP data is complete, you return to the Use Dedicated 
Service Tools (DST) menu. 


Task 3—Remove the Disk Unit from the Auxiliary Storage Pool 
Configuration 
To remove the disk unit from the ASP, do the following: 
1. If you are not already using DST, perform _a manual IPL to start DST. See|How] 
2. From the Use Dedicated Service Tools (DST) menu, do the following: 


a. Select option 4 (Work with disk units). 


b. Select option 1 (Work with disk configuration) on the Work with Disk 
Units display. 
c. Select option 3 (Work with ASP configuration) on the Work with Disk 
Configuration display. 
3. The Remove Units From Configuration display is shown. 
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- > 


Remove Units from Configuration 
Type options, press Enter. 
4=Remove unit from configuration 
Serial Resource 
OPT Unit ASP Number Type Model Name Status 
(i 1 10-@0A7529 9332 400 DDO10 Configured 
3 1 10-00A4936 9332 400 DDO12 Configured 
4 1 10-00A4936 9332 400 DDO14 Configured 
4 5 1 10-00A7498 9332 400 DDO15 Configured 
4 6 1 10-00A7498 9332 400 DDO17 Configured 
7 1 10-00A7530 9332 400 DDO18 Configured 
LL 8 1 10-00A7530 9332 400 DDO21 Configured y) 


4. Type a 4 (Remove unit from configuration) in the OPT column for each unit that 
you want to remove and press the Enter key. If the remove operation would 
leave the ASP with insufficient storage, you receive an error message. 

If you see the Confirm Remove Disk Units display, skip told 


The Confirm Continuation display may be shown before the Confirm Remove 
Disk Units display if the storage management directories are not usable. 


Confirm Continuation 


To proceed, the system must perform internal processing 
that may take several minutes during which the system may 
appear inactive. 


Press Enter to continue. 
Press Fl2=Cancel to return and change your choice. 


5. Determine whether you want to cancel the procedure or continue. If you want 
to continue, press the Enter key. 


6. The Confirm Remove Disk Units display is shown: 


fe >) 


Confirm Remove Disk Units 
Removing disk units will take several minutes. 
Press Enter to confirm remove of disk units. 


Press F9=Capacity information to display the capacity information. 
Press Fl2=Cancel to return to change your choice. 


Serial Resource 
OPT Unit ASP Number Type Model Name Status 
4 5 1 = 10-00A7498 9332 400 DDO10 Configured 
a 6 1 = 10-00A7498 9332 400 DDO12 Configured es 


Press F9 (Capacity information to display the resulting capacity. 
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- _ 


Resulting Capacity 


The configuration change that you requested would result in the 
following ASP capacities. 


Press Enter to continue. 


wee nnn--n-- Current----------  ----------Modified-------- 

--Protected-- -Unprotected- --Protected-- -Unprotected- 
ASP Threshold Size “Used Size %Used Size %Used Size Used 
1 90% 0 0.00% 1600 52.70% 0 0.00% 1200 70.26% 


——E—————E——————————————————————————— ee 


7. Press the Enter key to return to the Confirm Remove Disk Units display. 


8. Press the Enter key on the Confirm Remove Disk Units display to remove the 
selected units. The system moves the data off the units selected to be removed 
to the remaining units in the source ASP. The remove can take several minutes 
or several hours during which the system appears inactive. 


Notes: 
a. The time it takes to remove a unit depends on the disk unit type and 
model. 


b. If the data on the unit being removed is severely fragmented and the 
amount of storage used is high, the remove operation could take several 
hours. 


9. When the remove operation is complete, you return to the Work with ASP 
Configuration display. 


Press F3 until you return to the Use Dedicated Service Tools (DST) display. 
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Chapter 9. The Restore Menu 


The Restore menu provides many options for recovering information.|Figure 10 
shows the menu. Options marked with a plus sign (+) require the system to be in a 


restricted state. When your system is in a restricted state, that does not prevent 
client workstations from attempting to access information. If you have directories 
managed by the Windows server on iSeries, you should vary off the network 
server descriptions. 


(es 
RESTORE Restore 
Select one of the following: 


Restore Data 

Files 

Libraries 

Documents and folders 
Programs 

Other objects 

Licensed programs 
Configuration 

User profiles 

Objects in directories 


WOONAAHRWNE 


Figure 10. Restore Menu-—First Display 
You can page down on the Restore menu to see additional options: 


Restore System and User DataSystem/36'" 


+ 21. System and user data 


+ 22. System data only 
+ 23. All user data 
Restore Office Data 


30. All documents, folder, and mail 


31. Documents and folders 
32. Mail only 
33. Calendars 


Restore Libraries 


+ 40. All libraries other than system library 
41. All IBM libraries other than system library 
42. All user libraries 


Restore from Different Systems 


50. Restore from System/36 format 
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What the Restore Menu Options Do 


Following are the commands the system runs for the menu options that restore 
either the system, the system data only, or all user data. The name of the CL 
program that the system runs is in parentheses () following the description of the 
menu option. You can change this CL program if you need different values than 
the system-supplied defaults. 


Option Number |Description and Commands 


21 System and user data (QMNRSTE): 


ENDSBS SBS(*ALL) OPTION (*IMMED) 
RSTUSRPRF USRPRF(*ALL) 
RSTCFG OBJ(*ALL) 
RSTLIB SAVLIB(*NONSYS) 
RSTDLO DLO(*ALL) SAVFLR(*ANY) 
RST DEV('/QSYS.LIB/media-device-name.DEVD') 
OBJ(('/*') ('/QSYS.LIB' *OMIT) 
(*/QDLS' *0MIT)) 


RSTAUT 
STRSBS SBSD(controlling subsystem) 


22 System data only (QSRRSTI): 


ENDSBS SBS(*ALL) OPTION(*IMMED) 

RSTUSRPRF USRPRF (*ALL) 

RSTCFG OBJ(*ALL) 

RSTLIB SAVLIB(*IBM) 

RST DEV('/QSYS.LIB/media-device-name.DEVD') 
OBJ(('/QIBM/ProdData') 

('/QOpenSys/QIBM/ProdData')) 
STRSBS SBSD(controlling subsystem) 


23 All user data (QSRRSTU): 


ENDSBS SBS(*ALL) OPTION(*IMMED) 

RSTUSRPRF USRPRF(*ALL) 

RSTCFG OBJ(*ALL) 

RSTLIB SAVLIB(*ALLUSR) 

RSTDLO DLO(*ALL) SAVFLR(*ANY) 

RST DEV('/QSYS.LIB/media-device-name.DEVD') 

OBJ(('/*') ('/QSYS.LIB' *OMIT) 

('/QDLS' *OMIT) 
('/QIBM/ProdData' *OMIT) 
('/QOpenSys/QIBM/ProdData' *OMIT)) 

RSTAUT USRPRF (*ALL) 

STRSBS SBSD(controlling subsystem) 


How to Use Restore Menu Options 21, 22, and 23 


This topic describes the procedure for restoring information using option 21, 22, or 
23 from the Restore menu. The basic steps are the same for each menu option. 
Which option or options you use depends on which save menu option was used 


and_what other procedures, if any, you use to save information. This is discussed 
in |“Choosing the Procedure to Recover User Information” on page 107 


Before You Begin 


* Clean the read and write heads of the tape unit if you are restoring from a 
tape drive. 


1. Sign on the system using a user profile with sufficient authority to do the 
restore operation (such as QSECOFR). 
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Ensure that you load the correct volume of your last set of save media and 
make the device ready. The save media should contain the file labeled 
QFILEUPR. 


a. If you use tape media, run the DSPTAP command and specify 
DATA(*LABELS) to find the file labeled QFILEUPR. 


b. If you use DVD-RAM optical media, perform the following steps: 


1) From a command line run this command: DSPOPT VOL(*MOUNTED) 
DEV(OPTO1) DATA(*FILATR) PATH('QFILEUPR'). 


2) If the file is on the media, page down on your display to verify that 
the file is on the first volume. If the display says Continued from 
previous volume...NO, then the file QFILEUPR is on the first volume 
of your save media set. 

Ensure that any device configuration objects not used in the restore operation 

are varied off. You can use the Work with Configuration Status (WRKCFGSTS) 

command to display the status of devices. 

Ensure that the devices that you are using for the restore operation 

(workstations, devices, and device controllers) are varied on. These 

configuration objects are excluded from the restore operation (message 

CPF379C in the job log). 

Display the Restore menu: GO RESTORE. 

If you want to do an attended restore, skip to step |7} In most cases, you should 

do an attended restore operation to monitor for messages and correct any 

problems that occur. This helps your system return to operation as quickly as 

possible. If you want to do an unattended restore, do the following steps. This 

prevents your restore operation from stopping because of unanswered 

messages: 

a. Display the reply list sequence numbers to find what numbers are 
available for use: 

WRKRPYLE 

b. If MSGID(CPA3709) is not already in your reply list, add it. For xxxx, 

substitute an unused sequence number from 1 through 9999: 

ADDRPYLE SEQNBR(xxxx) MSGID(CPA3709) RPY('G') 

c. Change your job to use the reply list: 

CHGJOB INQMSGRPY (*SYSRPYL) 

Select the option (21, 22, or 23) from the Restore menu. After pressing the 
Enter key, you are shown the Specify Command Defaults display: 


i 


Type choices, press Enter. 


Specify Command Defaults 


DOVAIGOS: i202 coe, ccna ae cer cee as TAPO1 Names 


Prompt for commands ..... ¥; Y=Yes, N=No 


Message queue delivery... .  *BREAK *BREAK, *NOTIFY 


Restore to different system. . N Y=Yes, N=No 
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8. 


10. 


ale 


12; 
13. 


14. 


Type your choices for the Device prompt. You can specify up to four device 
names. If you specify more than one device, the system automatically switches 
to the next device after it finishes reading the current save media. 


Type your choice for the Prompt for commands prompt. Specify N (No) if you 
want to run an unattended restore. Specify Y (Yes) if you want to change the 
defaults on the RSTxxx commands. 


Type your choice for the Message queue delivery prompt. Specify *NOTIFPY if 
you want to do an unattended restore. This prevents communications 
messages from stopping the restore procedure. If you specify *NOTIFY, 
severity 99 messages that are not associated with the restore operation do not 
interrupt the restore process. For example, messages that request a new 
volume to be loaded interrupt the restore operation because they are 
associated with the job. You cannot continue until you reply to these 
messages. 


Specify *BREAK, if you want to be interrupted for severity 99 messages that 
require a reply. 

Type your choice for the Restore to different system prompt. If you specify Y 
(Yes), the following values will be specified. The system requires these values 
in order to perform a system recovery to a different system or to a different 
logical partition. 

* SRM(*NONE) will be specified on the RSTCFG command 

* ALWOBJDIF(*ALL) will be specified on all the restore commands 

* MBROPT(*ALL) will be specified on the RSTLIB command 

After you type your choices, press the Enter key. 


If you responded Y to the Prompt for commands prompt, you are shown the 
End Subsystem display. Type any changes and press the Enter key. While the 
system is ending subsystems, you see and respond to these messages: 


a. CPF0994 ENDSBS(*ALL) command being processed. Press the Enter key. 
b. CPF0968 System ended to restricted condition. Press the Enter key. 


If you responded N to the Prompt for commands prompt, skip to step[15 on| 
page 215 


When the system is ready to perform each major step in the restore process, 
you are shown the prompt display for that step. The time between displays 
may be quite long. 

For option 21, you are shown these displays: 

* ENDSBS SBS(*ALL) OPTION(*IMMED) 

* RSTUSRPRF USRPRF (*ALL) 

* RSTCFG OBJ(*ALL) 

* RSTLIB SAVLIB(*NONSYS) 

* RSTDLO DLO(*ALL) SAVFLR(*ANY) 


¢ RST DEV('/QSYS.LIB/media-device-name.DEVD') OBJ(('/*') 
('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT)) 


e RSTAUT 
¢ STRSBS SBSD(controlling subsystem) 


For option 22 (System data only) you are shown these displays: 
* ENDSBS SBS(*ALL) OPTION(*IMMED) 

* RSTUSRPRF USRPRF (*ALL) 

* RSTCFG 
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15. 


16. 


¢ RSTLIB SAVLIB(*IBM) 


° RST DEV('/QSYS.LIB/media-device-name.DEVD') 
OBJ(('/QIBM/ProdData') ('/QOpenSys/QIBM/ProdData' ) ) 


¢ STRSBS SBSD(controlling-subsystem) 


For option 23 (All user data) you are shown these displays: 

¢ ENDSBS SBS(*ALL) OPTION(*IMMED) 

* RSTUSRPRF USRPRF(*ALL) 

* RSTCFG 

* RSTLIB SAVLIB(*ALLUSR) 

* RSTDLO DLO(*ALL) SAVFLR(*ANY) 

¢ RST DEV('/QSYS.LIB/media-device-name.DEVD') OBJ(('/*') 


('/QSYS.LIB' *OMIT) ('QDLS' *OMIT) ('/QIBM/ProdData' 
*OMIT) ('/QOpenSys/QIBM/ProdData' *OMIT)) 
e RSTAUT 


¢ STRSBS SBSD(controlling-subsystem) 
Type your changes, if any, when the display is shown and press the Enter key. 


Note: The RSTAUT command will run immediately after the RST commands 
when you use option 21 or option 23. If you use option 22 only, you 
must run the RSTAUT command. You are not shown the display for 
the RSTAUT command because it has no parameters. You cannot 
prevent it from running when your restore using the menu options. If 
you have additional restore operations to run, you may need to restore 
security data and restore authority again after those restore operations. 


When the system sends a message asking you to load the next volume, load 
the next media volume and respond to the message. 


;— If a media error occurs... 
If an error occurs during the restore operation, see |“Recovery from an 
Unsuccessful Restore Operation” on page 58 


If an unrecoverable error occurs when running the RSTDLO DLO(*ALL) 
SAVFLR(*ANY) command, see|“Recovering from an Error While 
Restoring DLOs” on page 59 


If you used the distribution media to restore the operating system, some 
information was not restored. If you are restoring to a different system, the 
network attributes may have been reset to the IBM-supplied defaults. You 
must create or change this information again. You should have lists of this 
information that were created at the time you performed your save operation. 


The following may need to be created or changed: 
* Configuration lists 

* Network attributes 

* Edit descriptions 

* Reply list entries 

* IBM-supplied subsystem descriptions 

a. For the configuration lists, do the following: 
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17. 


18. 
19. 


20. 


Use the Work With Configuration Lists (WRKCFGL CFGL(*ALL)) 
command to create the configuration lists to match the information in your 
list. 

b. For network attributes, do the following: 
Use the Change Network Attributes (CHGNETA) command to change the 
network attributes to match the information in your list. 

c. For edit descriptions, do the following: 
Use the Work with Edit Descriptions (WRKEDTD EDTD(*ALL)) command 
to create edit descriptions to match the information in your list. 

d. For reply list entries, do the following: 
Use the Add Reply List Entry (ADDRPYLE) command to add reply list 
entries to match the information in your list. 

e. For IBM-supplied subsystem descriptions, do the following: 
Use the Work with Subsystem Descriptions (WRKSBSD SBSD(*ALL)) 


command to change the IBM-supplied subsystem descriptions to match the 
information in your list. 


If you need to restore independent ASPs, see 
Independent ASP” on page 206 


This completes the restore operation. 

If you are unsure what the QSECOFR password is, change it now. To see if 
the password has expired, type the following: 

DSPUSRPRF QSECOFR 


The passwords from your save media are now the current passwords. If the 
password expiration is active for the QSECOFR user profile, you will see the 
expiration date on the Date password expired field. If the date is the current 
system date or prior, change the password for the QSECOFR user profile. 
Check the job log to ensure all objects were restored. 

The job log contains information about the restore operation. To verify that all 
objects were restored, you should spool the job log for printing, along with 
the job’s remaining spooled output, if any. 

DSPJOBLOG * *PRINT 


Or 
SIGNOFF *LIST 


Message CPC3703 is sent to the job log for each library that was successfully 
restored. Message CPF3773 is sent to tell you how many objects were restored. 
It also tells you how many objects were not restored. Objects are not restored 
for various reasons. Check for any error messages, correct the errors, and then 
restore those objects from the media. 
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Chapter 10. How to Restore Specific Types of Information 


This chapter describes procedures for restoring particular types of information on 
the system. It also describes considerations when you restore particular types of 
information, whether you restore the information by using menu options or 
commands. The topics are presented in the same order as the recovery operations 
should occur. 


Recovering System Information 


You can customize some system information, such as edit descriptions and 
network attributes. When you run the SAVSYS command this system information 
is saved. It cannot be saved separately. 


If you have SAVSYS media and need to restore system information, follow the 
procedure that is desorbed inlChapler© “Restoring the Operaiine System] Do un 
abbreviated installation of the operating system. 

If you have restored your operating system from distribution media, you need to 
ses chetnct <yatein thf evisaon PBanene cysteine oon on area bes 
how to print the system information. Find the most recent listings you have. 

Frable 43] shows the commands for changing the system information to the correct 


values: 


Table 43. Commands for Changing System Information 


Information Type Command 
Access path recovery times! EDTRCYAP 
Configuration lists WRKCFGL 
Edit descriptions WRKEDTD 
IBM-supplied subsystem descriptions WRKSBSD 
Network attributes CHGNETA 
Reply list entries ADDRPYLE 
Service attributes CHGSRVA 
System values WRKSYSVAL 


x When you reset your access path recovery times, ensure that the ASP configuration 


matches the configuration at the time that you printed the recovery times. If it does 
not, make a note to reset your access path recovery times after recovering your ASP 
configuration. 


Sequence for Restoring Security Information 


Security information on your system consists of: 

* User profiles and group profiles 

* Authorization lists 

* Authority holders 

* Authority information that is stored with objects: 
— Owner 
— Owner authority 
— Primary group 
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— Primary group authority 
— Public authority 


¢ Private authorities 


It is essential that you restore security information in the correct sequence. 
Otherwise, object ownership and authority information is not restored correctly 
and your applications may not run correctly. The recovery checklists include the 
correct sequence of steps for restoring security information. If you are developing 
your own restore procedure, restore security information in the following sequence: 


1. Restore user profiles. The user profile that owns an object must exist before the 
object can be restored. 


If you restore all user profiles (RSTUSRPRF USRPRF(*ALL)), you also restore 
authorization lists and authority holders. Authorization lists and authority 
holders must also be on the system before you restore objects. 


2. Restore objects. This restores ownership and the authority information is stored 
with the object. 


3. Restore authority. This restores users’ private authorities to objects. 


Restoring User Profiles 


You can restore a single user profile, a list of user profiles, or all user profiles. You 
restore a user profile to move a user from one iSeries server to another iSeries 
server and to recover a damaged user profile. 


You can use the *NEW value on the USRPRF parameter to restore only user 
profiles that are new to your system. If you choose to restore individual user 
profiles, you can specify SECDTA(*PWDGRP) to restore passwords and group 
connections. These values are useful if you are merging user profiles from multiple 
systems onto a single system. 


You may also find the *NONE value beneficial if you only want to restore the data 
needed to verify signatures, and not all of the actual user profiles. 


The OMITUSRPRF parameter allows you to limit the number of user profiles you 
restore. You can specify a list of up to 300 specific or generic user profile values 
that will not be restored. This value is helpful if you are restoring a subset of user 
profiles. 


The SAVASPDEV parameter allows you to limit the private authorities that are 
restored based on auxiliary storage pools. 


Note: You cannot delete an IBM-supplied user profile if it is damaged. You must 
restore the operating system again to recover a damaged IBM-supplied user 


profile. 

Table 44. How User Profiles Are Restored 

Method Restricted State? 
RSTUSRPRE command 1? No 

Restore menu option 8 '° No 

Restore menu option 21 '7 Yes 

Restore menu option 22 '7 Yes 

Restore menu option 23 12 Yes 
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Table 44. How User Profiles Are Restored (continued) 
Method Restricted State? 


You must have *SAVSYS special authority. You must have *ALLOBJ special 
authority to specify ALWOBJDIF(*ALL). 


These menu options restore all user profiles. 


You need to put the system in a restricted state if you specify USRPRF(*ALL). 


Do This to Restore All User Profiles 
1. Sign on as QSECOFR. 


2. Ensure the system is in a restricted state. See |Putting Your System in al 
Restricted State” on page 4 


3. Find the most recent media volume that has your user profiles. It may be a 
SAVSYS volume or a SAVSECDTA volume. The name of the file on the media 
volume is QFILEUPR. 

4. If you are using a SAVSYS media volume, type: 


RSTUSRPRF DEV(media-device-name) USRPRF(*ALL) 
ENDOPT (*LEAVE) 


If you are using a SAVSECDTA media volume, type: 


RSTUSRPRF DEV(media-device-name) USRPRF(*ALL) 
ENDOPT (*UNLOAD) 


What Happens When You Restore User Profiles 
When you restore a user profile, you restore all the attributes of the profile that 
you see on the Display User Profile display. The system builds a working table that 
holds that user’s private authorities to objects. You must use the Restore Authorit 
RSTAUT) command to restore the user’s private authorities. (See 
[Anthorites" on pase 27) If you specify SECDTA (*PVTAUT), then only the 


working tables that hold the user’s private authorities are restored. The user 
profiles themselves are not restored. 


Some values in a user profile may be changed when it is restored. |Table 45 on 
lpage 224] shows the actions the system takes when you restore user profiles: 
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Table 45. Results of Restoring User Profiles 


Restore Procedure Used 


User Profile 


Attributes Restore *ALL User Profiles 


Restore Individual User Profile 
That Already Exists on System 


Restore Individual User 
Profile That Does Not Exist on 
System 


Group profile Value is restored from media 
(GRPPRF) 
Owner 
(OWNER) of 
new objects 
Group 
authority 
(GRPAUT) to 
new objects 
Password 
Document 
Password 
Date password 
was last 
changed 
Owner of user 
profile 


Value is restored from media 


Value is restored from media 


Value is restored from media 
Value is restored from media 


Value is restored from media 


See 
Establishes Ownership for 


Restored Objects” on page 226 


See |“How the System 


Establishes the Primary Group 
for Restored Objects” on 


Primary group 
of user profile 


*ALLOBJ See 
special 
authority 

User Value on system is not 
identification changed. 


number (UID) 


Group 
identification 
number (GID) 


Value on system is not 
changed. 


Value on system is not changed : 


Value on system is not changed 


Value on system is not changed i 


Value on system is not changed : 
Value on system is not changed 7 


Value on system is not changed 1 


Value on system is not changed 


Value on system is not changed. 


See|“What You Should Know) 
About Restoring User Profiles” 


Value on system is not changed. 


Value on system is not changed. 


Value is set to *NONE ? 


Value is set to *USRPRF 


Value is set to *NONE ? 


Value is set to *NONE ! 
Value is set to *NONE ! 


The current date is used. 


Value is restored from the 
media. If the owning profile 
does not exist, ownership is 
assigned to the QODFTOWN 
user profile. 

Value is restored from the 
media. If the primary group 
does not exist, the value in the 


user profile is set to *NONE. 
See |“What You Should Know, 
About Restoring User Profiles” 


Value is restored from the 
media unless it is a duplicate of 
a UID on the system. In that 
case, a new UID is generated. 
Value is restored from the 
media unless it is a duplicate of 
a GID on the system. In that 
case, a new GID is generated. 


Note: This situation does not apply when migrating from a System/38"™'. See the System/38 Migration Planning book 


for more information. 


1 If you specify SECDTA (*PWDGRP) the value is restored from media. 


What You Should Know About Restoring User Profiles 


When you are restoring user profiles from a source system to a target system, you 
must make sure that the password level values (QPWDLVL) are compatible. For 
example, restoring a user profile from the source system with a password value of 
2 may result in an invalid password on the target system with a password value of 
0 or 1. Password level 2 allows more characters than password level 0 or 1. 


Keep these things in mind when you restore user profiles: 
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Restoring All Profiles: When you restore all profiles, the system does not first 
delete all profiles, authorization lists, and authority holders on the system. 
Therefore, the result is both of the following: 


* All the profiles, authorization lists, and authority holders on the media. 


* Any profiles, authorization lists, and authority holders on the system that were 
not on the save media. 


Restoring all profiles is the only way to restore authorization lists and authority 
holders. However, if an authorization list secures an object in library QSYS, the 
association between the authorization list and the object is not restored 
automatically. This is because the objects in QSYS library are restored before the 
authorization lists. In other words, the object stores the name of the authorization 
list it is associated with, and the authorization lists are stored with the user 
profiles. Since QSYS is restored before the RSTUSRPRF command executes, the 
authorization list is not on the system at the time the object in QSYS is restored. 
The IBM publication, An Implementation Guide for iSeries Security and Auditing, 
contains sample programs (ALLAUTL and FIXAUTL) that can be used to attach 
authorization lists to the objects in library QSYS when the authorization lists are 
restored. ALLAUTL must be run before the operating system is restored or 
reinstalled in order to create a database of the objects secured by authorization 
lists. FXXAUTL must run afterwards to re-establish the links. These programs may 
need to be modified to meet your own requirements. 


(— Security Note 
If the IBM-supplied user profiles have the default passwords on your save 
media, they will again have default passwords after you restore. This is a 
security exposure. After a restore operation, verify that the IBM-supplied user 
profiles do not have the default passwords. 


Restoring *ALLOBJ Special Authority: *ALLOBJ special authority is removed from 
user profiles being restored to a system at security level 30 or higher in either of 
these situations: 


* The profile was saved from a different system, and the person doing the restore 
does not have *ALLOBJ and *SECADM authority. 


* The profile was saved from the same system or a different system at security 
level 10 or 20. 


The systems keeps *ALLOBJ special authority for the following system user 
profiles: 


°° OSYS 

* QSECOFR 

* OQLPAUTO 

* QOLPINSTALL 


Moving Users to Another System: To transfer user profiles and their authorities to 
another system, do the following: 


1. Save the user profiles and authorities by using the SAVSECDTA command. 
2. Save the owned objects. 


3. Restore the user profiles by using RSTUSRPRF USRPRF(*ALL) 
ALWOBJDIF(*ALL). 
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Note: You may want to consider using the USRPRF(*NEW) parameter to 
restore only user profiles which do not currently exist on the target 
system. Also, you can omit profiles that you do not want to restore with 
the OMITUSRPRF command. 

4. Restore the needed objects by using the RSTLIB, RSTOBJ, RST, or RSTDLO 
commands by specifying ALWOBJDIF(*ALL). 

5. Restore the private authorities of the user profiles by using the RSTAUT 
command. 


Chapter 15, “Release-to-Release Support” on page 323) provides more information 


about moving objects between systems running different releases of the operating 
system. The iSeries Security Reference book provides more information about these 
security features. 


How the System Establishes Ownership for Restored Objects 


Most objects on the system have an owner. The exception to this is objects in the 
QNTC and ONetWare file systems because most PC applications do not have a 
concept of object ownership. 


When you restore an object, the system determines what profile owns the restored 
object by using the following rules: 


* Ownership is restored to that profile if the profile that owns the object is on the 
system. 


* If the owner profile does not exist on the system, ownership of the object is 
given to the QDFTOWN (default owner) user profile. 


* If the object exists on the system and the owner on the system is different from 
the owner on the save media, the object is not restored unless 
ALWOBJDIF(*ALL) is specified. In that case, the object is restored and the owner 
on the system is used. 


° See |‘How the System Restores Programs” on page 260| for additional 


considerations when restoring programs. 


How the System Establishes the Authorization List for a 
Restored Object 
shows what happens when you restore an object that already exists if the 
object is linked to an authorization list. These rules do not apply when you are 
restoring a document or a folder. 
Table 46. Restoring an Object Linked to an Authorization List 


Authorization List on System Value of ALWOBJDIF 


and Media Parameter Result 

Same Any Data restored; link to authorization list not 
changed. 

Different *NONE Object is not restored 

Different *ALL Data restored; linked to authorization list 


associated with existing object. 


How the System Establishes the Primary Group for Restored 
Objects 


Many objects on the system have a primary group. When you restore an object, the 
system determines the primary group for the object by using the following rules: 
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* If the profile that is the primary group for the object is on the system, that 
profile is the primary group for the object. 

* If the profile that is the primary group for the object is not on the system, the 
primary group is set to *NONE. Message CPI380E is sent to the job log. 

* If the object exists on the system and the primary group on the system is 
different from the primary group on the save media, the system does not restore 
the object unless you specify ALWOBJDIF(*ALL). In that case, the system 
restores the object with the primary group on the system. 


Restoring Object Authorities 


Restoring a user’s private authorities to objects is a separate task from restoring 
user profiles. When you restore user profiles, the system builds authority reference 
tables for each user profile that you restore. The authority reference tables 
temporarily hold the user’s private authorities to objects. 


Possible Method Restricted State? 
RSTAUT command * No 
Restore menu option 21 Yes 
Restore menu option 22 ? Yes 
Restore menu option 23 4 Yes 


1 


You must have *SAVSYS special authority. 


Overview of Restoring Authorities 


When you run the Restore Authority (RSTAUT) command, the system restores 
authority for each user you specify. You can restore authority for a specific user 
profile, a list of specific user profiles, or all user profiles. If you restore authority 
for all users, the RSTAUT command restores authority by using every authority 
reference table it finds on the system. If you restore a single user profile to the 
system because it was damaged, deleted, or is being moved from another system, 
you can also use RSTAUT and specify that profile name to restore authorities for 
that user profile. 


When you run RSTAUT USRPRF(*ALL), you will receive status message CPI3821 
informing you of the current number of user profiles for which restore authority is 
complete after each authority reference table is processed. 


You may run the RSTAUT command regardless of whether or not a system is in a 
restricted state. However, there are differences between running RSTAUT on 
systems in a restricted state and running RSTAUT on systems in a non-restricted 
state. These differences include system performance, job log appearance, and object 
availability. More information is provided below. 


Note: The system saves and restores authorities differently for objects in the OQNTC 
and QNetWare file systems. The system saves and restores all authorities, 
including private authorities, with the object. 
iSeries Integration for Windows Server Product” on page 270|provides more 
information. 


Restoring authorities should be the last thing you do before performing an IPL, in 
a recovery. If you restore authorities and accept the default parameter for RSTAUT 
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SAVASPDEV(*ALLAVL), but you still have additional restore operations to 
perform, you may need to restore security data and restore authority again after 
the additional restore operations. 


You can also restore authority for a specific profile or a list of profiles. For 
example, if you have restored a single user profile to the system because it was 
damaged, you can also use the RSTAUT command and specify that profile name. 


Restoring Authority On a System in a Non-Restricted State 


The RSTAUT command uses prestarted jobs in order to process more than one 
user’s authorities at a time. The prestarted jobs that are used by RSTAUT use 
subsystem description QSYSWRK in library QSYS, program QSRRATBL in library 
QSYS, and class QINTER in library QGPL. 


There are several advantages to running the RSTAUT command on a system in a 
non-restricted state. These advantages include the following: 


* Because more than one user’s authority reference tables are being processed at a 
time, the RSTAUT command on a system in a non-restricted state is up to 30% 
faster in most cases than the same command on a system in a restricted state. 
Generally, the more user profiles for which RSTAUT is being run, the greater the 
performance gain for the RSTAUT command overall. 


* Subsystems do not have to be terminated when one or more user profiles are 
restored without a full system recovery. 


* Authority reference tables are not always deleted after RSTAUT is run for a user 
profile. If all private authorities are successfully granted or an abnormal error 
occurs then the authority reference table is deleted. Authority reference tables 
are also deleted if you create a data area named QSRCLRAUTS and it exists in 
the library list. However, if some of the private authorities are not granted for 
any reason such as ‘object not found’ or ‘object in use’, then the entries for those 
private authorities that were not granted are kept in the authority reference 
table, and the RSTAUT command may be run again for the user profile to try 
granting the failed private authorities before the next restore of the user profile. 


There are also some limitations to running the RSTAUT command on a system in a 
non-restricted state. These limitations include the following: 


* Because the system is not in a restricted state, all objects must be locked by 
RSTAUT. This means that several objects could be in use during the processing 
of any authority reference table. If the RSTAUT command is unable to lock an 
object, a diagnostic message of CPF3736 or CPD3776 will be sent to the job log 
of the prestarted job for each object that could not have authority granted. This 
is most likely to occur when the object is a user profile or a message queue. 
Since private authorities that are not granted are kept in the authority reference 
table, the RSTAUT command may be run again to grant authorities to objects 
that were in use. 

* If you are running RSTAUT for a large group of user profiles that have private 
authorities to the same few objects, it is recommended that you put the system 
in a restricted state before running the RSTAUT command. This will minimize 
the number of objects in use and consequently minimize the number of objects 
that are found locked by the RSTAUT command. 


* Only one RSTAUT command may be run on a system at a time. 


What You Should Know Before Running RSTAUT 
There are some general facts you should be aware of when running RSTAUT on a 
system in a non-restricted state. 
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* This command may take a long time depending on how many private 
authorities that you have on your system. 


* During system recovery, you should not start all subsystems and allow all users 
to sign on and use the system while RSTAUT is being run. The only subsystem 
that is needed to run RSTAUT in a non-restricted state is QSYSWRK. Allowing 
all users access to the system before RSTAUT completes may cause many more 
objects to be locked, preventing a larger number of the private authorities from 
being restored. 


* All private authorities for all authority reference tables that are processed by one 
prestarted job may or may not be successfully regranted. If they are regranted, 
then the message logging level that is used for that prestarted job will be the 
same as the logging level that is used by the user’s main job. 


If one or more private authorities for an authority reference table are not 
successfully regranted, then LOG(*SECLVL) will be used for the message logging 
for that prestarted job. 


For example, you could run the RSTAUT command with the system default 
logging level of LOG(4 0 *NOLIST). All prestarted jobs that are run by RSTAUT 
that have all private authorities regranted successfully will use the LOG(4 0 
*NOLIST) message logging level. The job log will not remain on the system after 
the prestarted job completes. All prestarted jobs that are run by RSTAUT, that 
have one or more private authorities that are not regranted, will instead use the 
LOG(4 0 *SECLVL) logging level. The job log will remain on the system after the 
prestarted job completes. 


* Do not cancel any of the prestarted jobs RSTAUT has started. Doing so will 
cause the entire RSTAUT command to cancel, similar to cancelling a RSTAUT 
command on a restricted state system. 


* One user’s authority reference tables are always processed by a single prestarted 
job. 

* If the authority reference tables are small, one prestarted job may process more 
than one user’s authorities. 


Subsystem QSYSWRK must be started in order for the prestarted jobs to start. The 
RSTAUT command will start several prestarted jobs at once, and assign the restore 
of authorities for one or more user profiles to each of the prestarted jobs. During 
the RSTAUT command, when the prestarted jobs are running, an entry will appear 
for each prestarted job on the Work with Active Jobs screen. 


Work with Active Jobs MYSYSTEM 
05/01/97 16:02:05 
CPU %: 26.5 Elapsed time: 00:00:31 Active jobs: 94 


Type options, press Enter. 
2=Change 3=Hold 4=End 5=Work with 6=Release /7=Display message 
8=Work with spooled files 13=Disconnect ... 


Opt Subsystem/Job User Type CPU % Function Status 
__—_ QSYSWRK QSsYS SBS ull DEQW 
QSRRATBL QUSER PJ 12 RUN 
—— — QSRRATBL QUSER PJ 1.0 RUN 
Ne J 


If subsystem QSYSWRK is active but the prestarted jobs cannot be started for any 
reason, you should receive messages in your job log, including escape message 
CPF386D, stating why the prestarted jobs could not be started. 


Chapter 10. How to Restore Specific Types of Information 229 


Job Log Considerations 

The job logs that are generated by a RSTAUT command running on a system in a 
non-restricted state are significantly different than those for a system in a restricted 
state. When the RSTAUT command runs on a system in a restricted state, one job 
log is generated. When the RSTAUT command runs on a system in a non-restricted 
state, each prestarted job (run by RSTAUT) generates a job log that contains some 
of the information that is found in the single job log that is produced on a system 
running in a non-restricted state. If only one user profile is being restored, only 
one job log is produced. 


You may encounter a situation where job logs that contain diagnostic messages 
from prestarted jobs that ran during the RSTAUT get deleted. If this occurs, you 
can rerun the RSTAUT command at any time before running another RSTUSRPRF 
command or RCLSTG command. The system will attempt to regrant the failed 
private authorities, and will generate new job logs. 


Figures [14] through[13} show a sample job log and message information for a 
RSTAUT USRPRF(QPGMR) command run on a system in a restricted state. 


>RSTAUT USRPRF (QPGMR) 

Authority not restored for user QPGMR. 

Some authorities not restored for user profile QPGMR. 
Not all user profiles had all authorities restored. 


Figure 11. Sample Job Log for RSTAUT on a System in a Restricted State 
The expanded text for message CPF3736 appears as follows: 


Additional Message Information 


Message ID......: CPF3736 Severity......: 20 

Message type....: Diagnostic 

Date sent ......: 04/24/97 Time sent......: 19:35:17 
Message....: Authority not restored for user QPGMR. 

Cause......: Private authority for DTAARA DTAARA1 in library QGPL was 


not restored. Either the object does not exist, is damaged, or was not 
available at the time authority was being granted. 
Recovery...: 
Do one of the following: 
--If the system was dedicated while the RSTAUT command was running, 
display the description of the object (DSPOBJD command). If the object was 
damaged or not found, restore the user profile (RSTUSRPRF command), restore 
the object (RSTOBJ command), and restore the authorizations (RSTAUT command). 
If the object exists and is not damaged, report the problem (ANZPRB command). 


Figure 12. Expanded Text for Message CPF3736 


The expanded text for message CPF3845 appears as follows: 
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Additional Message Information 


Message ID......: CPF3845 Severity......: 20 

Message type....: Diagnostic 

Date sent ......: 04/24/97 Time sent......: 19:35:17 

Message....: Some authorities not restored for user profile QPGMR. 
Cause......: 1434 authorities were restored and 1 authorities were not 


restored for user profile QPGMR at 04/24/97 19:21:36. 

The prestart job name used to restore private authorities for this user 
profile is *N. The prestart job name that contains messages about 
authorities not restored is *N. 

--If the job name above is *N then a prestart job was not used to restore 
authorities for this user profile. 

--If a job name other than *N is listed above, then a prestart job was 
used to restore private authorities for this user profile and messages may 
be found in the joblog for the job name listed. Use one of the following 
commands to display the joblog for the prestarted job: 


Figure 13. Expanded Text for Message CPF3845 


In the case of a system in a restricted state, all messages appear in the user’s main 
job log. When the name of the prestarted job that is used in message CPF3845 is 
*N, then no prestarted job was used. 


Figures [14] and [15] show a sample job log message information for a RSTAUT 
USRPRF(QPGMR QUSR) command run on a system in a non-restricted state. 


>RSTAUT USRPRF(QPGMR QUSR) 

Start of prestart jobs in progress. 

Some authorities not restored for user profile QPGMR. 
Private authorities restored for user profile QUSR. 
End of prestart jobs. 

Not all user profiles had all authorities restored. 


Figure 14. Sample Job Log for RSTAUT on a System in a Non-restricted State 
The expanded text for message CPF3845 appears as follows: 


Additional Message Information 


Message ID......: CPF3845 Severity......: 20 

Message type....: Diagnostic 

Date sent ......: 04/24/97 Time sent......: 19:35:17 

Message....: Some authorities not restored for user profile QPGMR. 
Cause......: 1433 authorities were restored and 2 authorities were not 


restored for user profile QPGMR at 04/24/97 19:21:36. 

The prestart job name used to restore private authorities for this user 
profile is 010648/QUSER/QSRRATBL. The prestart job name that contains 
messages about authorities not restored is 010648/QUSER/QSRRATBL. 

--If the job name above is *N then a prestart job was not used to restore 
authorities for this user profile. 

--If a job name other than *N is listed above, then a prestart job was 
used to restore private authorities for this user profile and messages may 
be found in the joblog for the job name listed. Use one of the following 
commands to display the joblog for the prestarted job: 


Figure 15. Expanded Text for Message CPF3845 
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In figure }15} the name of the prestarted job used is 010648/QUSER/QSRRATBL, and it 
appears in the CPF3845 message. The CPF3736 message for the data area 
DTAARA1 in library QGPL whose authority was not restored, does not appear in 
the user’s main job log. Instead, all messages that are related to restoring of 
individual private authorities are in the job log for the prestarted job. To view 
these messages, you would run the command. DSPJOB JOB(010648/QUSER/QSRRATBL), 
and then select option 4 to view the job log for the prestarted job. The expanded 
message text for CPF3736 appears in that job log. 


You should pay special attention to any CPF3845 message that states that *N 
authorities were not restored. This may indicate a problem such as damaged 
objects or a function check. Any CPF3845 message with *N authorities that are not 
restored should be investigated further by checking the job log of the prestarted 
job that is named. 


If all authorities in an authority reference table were restored successfully, then 
message CPC3706 is sent for the user profile instead of CPF3845. CPC3706 will also 
contain the name of the prestarted job that is used to restore authorities for the 
user profile. If all authorities restored from a prestarted job were restored 
successfully, then the job log for the prestarted job will contain only job start and 
end messages. 


The order of CPC3706 and CPF3845 messages depends on whether you run the 
RSTAUT command on a system that is in a restricted or non-restricted state. These 
messages are for user profiles with restored private authorities. The order of these 
messages is as follows: 


Restricted state system 
The order will generally be alphanumeric because only one authority table is 
being restored at a time, in alphanumeric order 


Non-restricted state system 
The order will generally be that these messages will appear first for the user 
profiles with fewer private authorities, then later for the user profiles with 
many private authorities. This is because multiple authority reference tables are 
being restored at once and the smaller authority reference tables usually 
complete first. 


Restoring Authority On a System in a Restricted State 


The RSTAUT command on a system running in a restricted state restores 
authorities for each authority reference table, one table at a time. No prestarted 
jobs are used. 


When processing is complete for an authority reference table, the table is deleted 
regardless of whether all private authorities were successfully restored or not. 


What the System Does When You Restore Authority 


When you run the RSTAUT command, the system grants all the private authorities 
that it finds in each authority reference table. The user’s private authorities after 
the command are both of the following: 


* The authorities from the temporary authority reference table. 
* Any authorities that are granted to the user since the save operation. 


How the System Restores Authority-Example 1: Assume that the authority to 
PRICES looks like this at the time of the save operation: 
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es = 
Display Object Authority 
Object. =. 3. hs PRICES Owner =... 33. 
ETDRARYS ue sn et ce ae CONTRACTS Primary group 
Object type ....: *FILE 
Object secured by authorization list .......... 
Object 

User Group Authority 

OWNCP *ALL 

DPTSM * CHANGE 

DPTMG * CHANGE 

WILSONJ *USE 

*PUBLIC *EXCLUDE 
we 4 


Note: Your display looks different when your user profile has a user option setting 
of *EXPERT. 


After you save security information, you grant and revoke several authorities to 


the PRICES file. Just before the restore operation, the authority looks like this: 


io a 
Display Object Authority 
ODJeCt Ray ee PRICES Owner 2.505. 255 
LiDranyo lee te assets CONTRACTS Primary group 
Object type ....: *FILE 
Object secured by authorization list .......... 
Object 

User Group Authority 

OWNCP *ALL 

DPTSM *USE 

DPTMG * CHANGE 

WILSONJ *EXCLUDE 

ANDERSP *USE 

*PUBLIC *EXCLUDE 
\ e/ 


If authority is restored for all users, the authority to the PRICES file looks like this: 
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Object. . 
Library 
Object type 


User 
OWNCP 
DPTSM 
DPTMG 
WILSONJ 
ANDERSP 

*PUBLIC 
XN 


oe 8 © © 


Object secured by authorization list 


Group 


Display Object Authority 


PRICES Owner 2. ss 
CONTRACTS Primary group 
*FILE 


Object 
Authority 
*ALL 
* CHANGE 
*CHANGE 
*USE 
*USE 
*EXCLUDE 


Authorities for DPTSM and WILSONJ are restored to the values they have on the 
save media. The authority for ANDERSP remains, even though it did not exist on 


the save media. 


How the System Restores Authority-Example 2: Assume that the authority for the 


PRICES file looks like this just before the restore operation: 


a 


Object. . 
Library 
Object type 


User 
OWNCP 
DPTMG 
WILSONJ 

*PUBLIC 
< 


@, iwt les Set Se: ce. 


— « « © 3 


Object secured by authorization list 


Group 


Display Object Authority 


PRICES Owner & 2% 42. 
CONTRACTS Primary group 
*FILE 


Object 
Authority 
*ALL 
*CHANGE 
* CHANGE 
*USE 


se 


If authority is restored for all users, the authority to the PRICES file looks like this: 
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Display Object Authority 
ODjJeCta. =. os. 2s : — PRICES Owner =... 4.3. 
Library) a 4: 27s : CONTRACTS Primary group 
Object type 224.7% “PILE 
Object secured by authorization list .......... 
Object 

User Group Authority 

OWNCP *ALL 

DPTSM * CHANGE 

DPTMG * CHANGE 

WILSONJ * CHANGE 

*PUBLIC *USE 

Ne y 
Notice that WILSONJ still has *CHANGE authority. The authority from the save 


media (*USE) is granted to WILSONJ, but the authority WILSONJ already has is 
not revoked. *USE authority is added to *CHANGE authority, so WILSONJ has 
*CHANGE authority. 


Notice also that *PUBLIC authority is not affected by this process. Public authority 
is stored with the object and is handled when the object is restored. If public 
authority on the system is different from public authority on the save media, the 
public authority on the system is used. 


Authority is restored to the object with the same name in the same library. In some 
cases, this could result in restoring authority to a different object. 


If you restore authorities for an independent ASP, you can use the SAVASPDEV to 
limit the authorities that you restore. For example, you can limit the authorities to 
a specific independent ASP, or an ASP group. Authority is restored to the object 
with the same name in the same library and the same independent ASP, unless 
you specify another value for the RSTASPDEV parameter. A user will have 
separate authority reference tables for each independent ASP to which he is 
authorized. 


Assume that you delete program PGMA in library CUSTLIB. You create a new 
program with the same name but different function. If you restore authority, users 


who were authorized to the original PGMA are now authorized to the new PGMA. 
See “How the System Restores Programs” on page 260} for more information. 


How to Restore Configuration Objects 


You can restore: 
* All configuration objects 
* A group of configuration objects by generic name 


* Only specific types of configuration objects, such as line descriptions or 
connection lists. 


* System resource management information 


A configuration object must be varied off before you can restore it. 
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Note: If you execute the restore configuration (RSTCFG) command against a 
printer device description and the output queue associated with that device 
description contains zero spooled files, the system will recreate the output 
queue. Any changes made to the output queue prior to the RSTCFG will be 
lost. 


Table 47. How Configuration Objects Are Restored 


Possible Method Restricted State? 

RSTCFG command 1 No 

Restore menu option 7 No 

Restore menu option 21 Yes 

Restore menu option 22 Yes 

Restore menu option 23 Yes 

7 You must have *ALLOBJ special authority to specify ALWOBJDIF(*ALL) 


Do This to Restore All Configuration Objects: 


1. Find the most recent media volume that has your configuration. It may be a 
SAVSYS volume or a SAVCFG volume. The name of the file on the volume is 
OFILEIOC. 


2. If you are using a SAVSYS media volume, type: 


RSTCFG OBJ(*ALL) DEV(media-device-name) 
OBJTYPE(*ALL) 
ENDOPT (*LEAVE) 


If you are using a SAVCFG media volume, type: 


RSTCFG OBJ(*ALL) DEV(media-device-name) 
OBJTYPE(*ALL) 
ENDOPT (*UNLOAD) 


(— Restoring to a Different System? 
You must specify ALWOBJDIF(*ALL) when you restore the configuration to a 
different system. (An option is available on the restore menu that indicates 
that you are restoring to a different system. If you selected this option, the 
system automatically specifies ALWOBJDIF(*ALL) for you.) 


The restoring of configuration objects to a different system whose 
configuration objects exist overlays the existing configuration. In some cases, 
the configuration description may not match the hardware on the system. 


Do not restore system resource management objects to another system. This 
may cause problems that can be fixed only by a service representative. When 
you use the RSTCFG command to another system, specify SRM(*NONE). 


Correcting Problems with the System Resource Management 
Information 


The system resource management (SRM) information provides a link between the 
hardware on your system and the software descriptions of that hardware (the 
configuration). When you restore your configuration to a different system, you 
should not restore the SRM information because it will not match the hardware on 
the target system. Sometimes during a system upgrade, you are instructed to 
restore the SRM information to your system even though some of your hardware 
has changed. 
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If you have restored the SRM information and the hardware configuration does not 
match, use the following procedure to correct the SRM information: 


i, 
2: 


Type STRSST and press the Enter key to access System Service Tools. 

Select Option 1 (Start a service tool) from the System Service Tools menu and 
press Enter. 

Select Option 7 (Hardware service manager) from the Start a Service Tool menu 
and press Enter. 

Select Option 2 (Logical hardware resources) from the Hardware Service 
Manager menu and press Enter. 

Select Option 1 (System bus resources) from the Logical Hardware Resources 
menu and press Enter. 


Select F10 (Non-reporting resources) to display any non-reporting resources. 
Any hardware resources that did not report during the last IPL or that were 
created during the last Restore configuration (RSTCFG) will be displayed. 


Type a 4 (Remove) in the Option column to delete any entry you are certain is 
not valid for this system’s configuration. 


Recovering Devices That Will Not Vary On 

If you have a problem with your devices, such as not being able to vary on a 
device, it may be because the system resource management (SRM) database that 
was restored does not match the device descriptions on the system. 


To correct the problem for a tape unit or a tape controller, do the following: 


1 


1 


1 


1. 


Type WRKHDWRSC TYPE(*STG). You are shown the Work with Storage Resources 
display. 

Type a 9 (Work with resource) in the Opt column next to the resource name 
that would not vary on. The Work with Storage Controller Resources display 
is shown. 

Write down the valid resource name for the device type and model that you 
tried to vary on. 


4. Press F12 (Cancel) until you return to a display with a command line. 


0. 


if 


2. 


If the problem is with a tape unit, other than a 3422, 3430, 3480, or 3490, skip 
to step 

Type WRKCTLD CTLD(controller-name). You are shown the Work with 
Controller Descriptions display. 

Type 2 (Change) in the Opt column next to the controller that would not vary 
on and press the Enter key. The Change Controller Description display is 
shown. Skip to step 

Type WRKDEVD DEVD(media-device-name). The Work with Device Descriptions 
display is shown. 

Type 2 (Change) in the Opt column next to the device description that you 
want to change and press the Enter key. The Change Device Description 
display is shown. 

Change the name in the Resource name prompt to the correct name for the 
resource and press the Enter key. You return to the Work with Device 
Descriptions display or the Work with Controller Descriptions display. 

Type 8 (Work with status) in the Opt column next to the device or controller 
that you changed and press the Enter key. The Work with Configuration 
Status display is shown. 

Type 1 (Vary on) in the Opt column next to the device description name or the 
controller description name. Press the Enter key to vary it on. 
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Local Workstation Controller: To correct the problem for a workstation, do the 
following: 
1. Type the following and press the Enter key to display the Work with Local 
Workstation Resources display. 
WRKHDWRSC TYPE(*LWS) 
2. Find the correct controller description for the device that would not vary on. 
3. Type a 5 (Work with configuration description) in the Opt column next to the 
controller description name and press the Enter key. The Work with 
Configuration Description display is shown. 
4. Type a 5 (Display) in the Opt column to display the valid resource name for 
the workstation controller. 
5. Press F12 (Cancel) until you return to a display with a command line. 
6. Type the following and press the Enter key to display the device description 
for the device that would not vary on. 
WRKCTLD CTLD(controller-name) 


The Work with Controller Descriptions display is shown. 


7. Type a 2 (Change) in the Opt column next to the controller description that 
you want to change and press the Enter key. The Change Controller 
Description display is shown. 


8. Change the name in the Resource name prompt to the correct name for the 
resource and press the Enter key. You will return to the Work with Controller 
Descriptions display. 

9. Type an 8 (Work with status) in the Opt column next to the controller 
description that you changed and press the Enter key. The Work with 
Configuration Status display is shown. 


10. Type a 1 (Vary on) in the Opt column next to the controller description name 
and press the Enter key to vary on the device. 


Note: It is possible that another device description is varied on for this 
resource. Vary off the device first and then vary on the changed device 
description. This situation can happen to the console device. 


Recovering When You Change the Console Type 

When you restore your information to a different system or an upgraded system, 

you may have a different console type on the target system. After you have 

restored user information, you need to create a new controller and device 

description. Do the following: 

1. Type WRKHDWRSC *LWS and press the Enter key. You are shown the Work with 
Local Work Station Resources display. 

2. Type a 5 (Work with controller descriptions) in the Opt column next to the 
name of the first workstation controller. Press the Enter key. You are shown the 
Work with Controller Descriptions display. 


Note: The first workstation controller may not be CTLO1. 


3. Type a 1 in the Opt column and press the Enter key. You are shown the Create 
Controller Description display. 


4. For the New controller description prompt, type the name that you want for the 
console. Press the Enter key. 


Note: If you want to use the name that you had on your old system, you must 
first delete the device configuration name and then re-create it. 
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5. Use the CRTDEVDSP command to create a device description for the console. 


Recovering the System/36 Environment Configuration 


If you are experiencing a problem with the System/36 environment after restoring 
the system, it may be caused by the locking rules used during the installation 
process. The QS36ENV configuration object in library #LIBRARY may have been 
locked by the System /36 environment. 


This object contains the System /36 environment names for the workstation, printer, 
tape and diskette units on the system, and default System/36 environment values 
used for all users. This object may have been modified by the Change 5/36 
Environment Configuration (CHGS36) command to customize the System /36 
environment. 


When the first subsystem is started on the system after the installation process is 
complete, a new #LIBRARY and a new QS36ENV object in #LIBRARY are created 
with the system defaults. In addition to creating the new objects, each subsystem 
holds a lock on the QS36ENV configuration object to ensure that it is not deleted. 
This lock will not allow the saved QS36ENV configuration object to be restored. 


If the QS36ENV configuration object did not restore, start with step|I| If the 
configuration object did restore but you are experiencing problems with the 
System /36 environment configuration, go to step 


1. Rename the newly created #LIBRARY to something else (for example, 
#LIBNEW). 


The locks held on the QS36ENV object remain with the renamed library. This 
allows the saved System/36 environment configuration object to be restored. 


2. Restore the saved copy of library #LIBRARY: RSTLIB SAVLIB(#LIBRARY) 
3. Perform an IPL of the system. 


The QS36ENV object in the restored copy of #LIBRARY is the System/36 
environment configuration again. 


4. Delete the earlier renamed version of #LIBRARY (for example, #LIBNEW). 


5. Use the Change S/36 Environment Configuration (CHGS36) command to 
refresh the configuration object. 


a. Select each of the device types that you want to change. 
* Workstation devices 
* Printer devices 
* Tape devices 
* Diskette devices 
b. For each device type that you want to change: 


1) Press the F5 key to ensure the configuration object matches the device 
descriptions on the system. 


2) If any System/36 names are not specified, do one of the following: 


* Press the F10 key to use the defaults for the System/36 names for 
those devices. 


* Update the System/36 names manually. 
c. Save the changes to the configuration object. 
See the topic on configuring the System/36 environment in the Concepts and 
Programmer's Guide for the System/36 Environment for more information about 


configuring the System /36 environment. 
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Restoring Logical Partitions 


Look for information on how to restore your Logical Partitions that is integrated 
throughout this book. The integrated steps include information on how to recover 
your logical partitions configuration data and your system and user data for each 
partition. 


Keep the following things in mind when you recover your system and user data: 
1. Recover your primary partition first. 
2. Recover each partition as if it is a stand-alone system. 


For more information about logical partitions, refer to the Information Center Web 
site at the following url: 


http://www. ibm.com/eserver/iseries/infocenter 


Restoring Libraries 


Restoring entire libraries is a common way to recover user information. Use the 
Restore Library (RSTLIB) command to restore a single saved library or a group of 
libraries. The RSTLIB command restores the entire library, including the library 
description, object descriptions (only descriptions are restored for logical files, job 
queues, message queues, output queues, user queues, and data queues), and the 
contents of other objects. This command also restores status information for 
programming temporary fixes (PTFs) that were in the library at the time the library 
was saved. 


When you use the RSTLIB command, you can use the OPTION parameter to 
specify which objects in a library are restored: 


Possible Values for the OPTION Parameter of the RSTLIB Command: 


*ALL Old objects are replaced and new objects are added to a library. 
*ALL is the default. 

*OLD Only old objects that already exist on the system are replaced in a 
library. 

*NEW Only objects not found on the system are added to a library. The 
old objects are not replaced. 

*FREE Only those objects that have their storage freed on the system are 
restored. 


Restoring a Library From a Previous Release 


When you are restoring a library that was saved on a system at an earlier release, 
you can use the Force object conversion (FRCOBJCVN) parameter to specify whether 


programs are translated when they are_restored. This can significantly impact the 
time it takes to restore the library. See|“Restoring Programs to a Different Release” 
for more information. 

Restoring Multiple Libraries 


You can use the RSTLIB command to restore libraries in these groups: 
*NONSYS 
All libraries that were saved with SAVLIB LIB@@7NONSYS) command, 


including the IBM-supplied libraries QGPL, QUSRSYS, and licensed 
program libraries. 
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*ALLUSR 
All user libraries that were saved with SAVLIB LIB(*ALLUSR) or SAVLIB 
LIB(*NONSYS). 


*IBM All IBM-supplied libraries that were saved with SAVLIB LIB(*IBM) or 
SAVLIB(*NONSYS). Only IBM-supplied libraries that contain IBM objects 
are restored. 


Figure 4 on page 42}shows which libraries are saved and restored in these groups. 


If you are restoring the QGPL library or the QUSRSYS library, you must restore 
them before restoring any other user libraries. If you use the special values 
(*ALLUSR or *NONSYS), the system restores these libraries in the correct 
sequence. 


When you restore a group of libraries (*ALLUSR, *NONSYS, or *IBM), you can 
omit up to 300 libraries by using the OMITLIB parameter. The libraries you omit 
are not restored from the save media. 


When you use a media definition to restore libraries that were saved in parallel 
with one of the following groups specified, *ALLUSR, *IBM, *NONSYS, or a 
generic value such as X*, you may have to perform some involved recovery 
operations. You must first load each drive with the volume that contains the QFILE 
so that the system can verify that each library resulted from the same save 
operation. You will then have to answer an inquiry message for each drive to 
position it to the correct volume, if you are starting the recovery on a library other 
than *FIRST. 


; Attention! 
If you have related objects, such as physical and logical files or journals and 


journaled objects, in different libraries, you must ensure that you restore them 
in the correct sequence. Read |“Sequence for Restoring Related Objects” on 


If you are restoring to a different system, specify ALWOBJDIF(*ALL) when 
you are restoring libraries. 


Considerations and Restrictions 
The following restrictions and considerations apply to the RSTLIB command: 


* You cannot restore a QDOCnnnn (Document) library by using the RSTLIB 
command. Use the Restore Document Library Object (RSTDLO) command to 
restore documents. 


* You cannot restore the QSYS (System) library by using the RSTLIB command. 


Use the procedures for restoring the operating system in to restore 
OSYS, 


* A RSTLIB command may run concurrently with a RSTOBJ or SAVOBJ command 
that uses the same library. 


* You may not run multiple concurrent RSTLIB commands that use the same 
library. 


* A RSTLIB and SAVLIB command may not run concurrently using the same 
library. 
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How to Restore All Libraries from a Single Save Operation 


Follow this procedure for restoring all libraries that were saved with a single 
command or menu option. 


1. Sign on with a user profile that has *SAVSYS special authority. Using *SAVSYS 
special authority ensures that you will not have authority problems during the 
restore procedure and improves restore performance. 


2. Ensure that the system is in a restricted state. For more information, see 
“Putting Your System in a Restricted State” on page 47 
3. Find your most recent save media. 


4. Use/|Task 4—Restoring Libraries to a Basic Auxiliary Storage Pool” on page 202 


Type your choice and press F4 (prompt). 
Table 48. Methods for Restoring All Libraries-Single Save Operation 


How Your Libraries Were Saved Type This to Restore Them 


Save Menu option 21 RSTLIB SAVLIB(*NONSYS) 
SAVLIB LIB(*NONSYS) RSTLIB SAVLIB(*NONSYS) 


5. Fill in your choices for other parameters, such as device and whether to rewind 
the tape in a tape device. Press the Enter key. 


6. If you receive messages to load a media volume, load the correct media volume 
and respond to the messages. 


7. When the restore operation completes, check your job log to see which libraries 
were restored and whether any objects were not restored. 


How to Restore All Libraries from Multiple Save Operations 


Following is the procedure for restoring all libraries if they were saved with 
multiple menu options or commands. Adapt the examples to fit your own save 


procedures and recovery situation. Before restoring multiple libraries, make sure 
that you read about|“Sequence for Restoring Related Objects” on page 46 
1. Sign on with a user profile that has *SAVSYS special authority. 


2. Ensure that the system is in a restricted state. 
3. Find your most recent save media. 
4 


Use |Table 49} repeat this step and step [5] for each command. Type your choice 
and press F4 (prompt). 


Table 49. Methods for Restoring All Libraries—Multiple Save Operations 


How Your Libraries Were Saved Type This to Restore Them 


Save Menu options 22 and 23 RSTLIB SAVLIB(*IBM) 
RSTLIB SAVLIB(*ALLUSR) 
Save Menu options 21 and 23 RSTLIB SAVLIB(*IBM) 
RSTLIB SAVLIB(*ALLUSR) 
SAVLIB *NONSYS followed by RSTLIB SAVLIB(*NONSYS) 
SAVLIB LIB(LIBA LIBB LIBC) OMITLIB(LIBA LIBB LIBC) 


RSTLIB LIB(LIBA) 
RSTLIB LIB(LIBB) 
RSTLIB LIB(LIBC) 


5. Fill in your choices for other parameters, such as device and whether you want 
to rewind the tape in a tape device or not. Press the Enter key. 


6. If you receive messages to load a media volume, load the correct media volume 
and respond to the messages. 
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7. When the restore operation completes, check your job log to see which libraries 
were restored and whether any objects were not restored. 


How to Restore Objects 


You can use the Restore Object (RSTOBJ) command to restore individual objects or 
an entire library. When you restore a library by using the RSTOBJ command, the 
library description is not restored. 


The following conditions apply when using the RSTOBJ command: 
* The RSTOBJ command restores objects to only one library. 
* Multiple concurrent RSTOBJ commands may be run against a single library. 


* Multiple concurrent RSTOBJ commands may run against a single library 
concurrently with the following commands: 


— The SAVLIB command 

— The RSTLIB command 

— One or more SAVOBJ commands 

— The RSTLIB command and the SAVOBJ command 
— The SAVLIB command and the SAVOBJ command 


Attention! 


Do not use RSTOBJ to restore licensed programs to library QSYS. 
Unpredictable results can occur. 


Restoring Objects That Are Journaled 


If the journal exists on the system before the journaled objects are restored, all 
objects that were saved while being journaled are journaled again provided one of 
the following is true: 


* The objects are not on the system at restore time. 

* The objects are on the system and journaling was not ended for the objects. 

* The journal is on the system, it is not damaged, and its journal state is not 
*INACTIVE. 


To find out which object types can be journaled and therefore have these restore 
considerations, refer to the Journal Management topic in the iSeries Information 
Center (http://www.ibm.com/eserver /iseries /infocenter). 


When you restore an object that was being journaled at the time of the save 
operation, an entry is written to the journal to indicate that it was restored. 


When you restore access paths that were being journaled at the time of the save 
operation, no journal entry is written to the journal to indicate that it was restored. 


If the journal is not on the system at the time a journaled object is being restored, 
the restore operation for the object causes a warning message to be sent and 


journaling is not resumed. This warning message causes a diagnostic message to 
be sent at the end of the restore operation. (See the topic|“How to Verify That 
Objects Are Restored Successfully” on page 56}) 
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What Happens When You Restore Journaled Objects to a 
Different Library or Directory 


The system assigns a unique internal journal identifier (JID) to every object that is 
journaled. If you restore a journaled object to a library or directory other than the 
original library or directory, and the object still exists on the system and continues 
to be journaled to the same journal, the JID of the restored object is changed. 
Message CPF70CB — "Journal identifier &2 is currently in use” is sent to the job 
log to confirm the changed JID of the restored object. 


All the journal entries associated with the media copy of the object have the 
original JID. You cannot apply these journal entries to the object that was restored 
to a different library or directory because it has a different JID. For this reason, you 
should avoid restoring a journaled object to a different library or directory. 


For example, in [Figure 16| the original object FILEA in LIBX library has an internal 
journal identifier of Z that is recorded with every journal entry associated with 
FILEA in LIBX. When FILEA is restored from the media to LIBC library, it is 
assigned the journal identifier of Y because FILEA still exists in LIBX and continues 
to be journaled. 


Journal Entries 


with JID of Z 
LIBX/FILEA Journal LIBC/FILEA 
< entries 
JID Z cannot be | JIDY 
applied 
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Figure 16. Example: Restoring a Journaled Object to a Different Library 


Any journal operation that references an object by name and involves using journal 
entries requires that the journal identifier of the object and the journal identifier 
recorded in the journal entries be the same. Because FILEA in LIBC has journal 
identifier Y, journal entries with journal identifier Z are not associated with the 
restored FILEA in LIBC. As a result, journal changes that are recorded for FILEA in 
LIBX cannot be applied to FILEA in LIBC. For the same reason, if you are 
referencing FILEA in LIBC on the Display Journal (DSPJRN), Receive Journal Entry 
(RCVJRNE), or Retrieve Journal Entry (RTVJRNE) commands, or on the Retrieve 
Journal Entries (QjoRetrieveJournalEntries) API, the entries for FILEA in LIBX are 
not returned. 


To display or retrieve the journal entries of the original object: 
1. Save and then delete the existing object on the system. 
Restore the original object to the system. 

Display or retrieve the journal entries. 

Delete the original object. 


af oN 


Restore the existing object back to the system. 
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Restoring Database Files 


You can restore one or more database files or one or more members of database 
files by using the RSTOBJ command. |Figure 17|shows, conceptually, how a 
database file with two members looks to the system. It has multiple parts: 


File A (Physical File) 


Attributes 
Access Path Definition 
Members 


;-_>MEMBER1 


Attributes 


Data 


Keyed Access Path 


'——>MEMBER2 


Attributes 


Data 


Keyed Access Path 
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Figure 17. Example of a Database File with Two Members 


If FILEA exists on the system and you restore it, the system restores the data and 
access paths for FILEA’s two members. The attributes for the file and its members 
are not changed on the system. 


If you want to restore the file attributes as they existed at the time of the save 
operation, delete the file, then restore it. If you want to restore the member 
attributes, remove the member (RMVM) and then restore it, specifying 
MBROPT(*NEW). 


When you restore a database file, the system uses information that is stored with 


the file and the parameters you specify to make decisions. The topics that follow 
describe special considerations when restoring database files and members. 
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Unique File Identification: You can restore a file only to itself. A saved version and 
a copied version of the same file are not the same and cannot be used 


interchangeably in a restore operation. |Figure 18] illustrates this: 
File Locking during Restore Operation: When you restore a file, no member of the 


Copied to 


FileA }——————»> | FileB 
SAVOBJ SAVOBJ 
M RSTOBJ;—* 
FileA File B 
on tape Not on tape 
allowed 
¥ RSTOBJ y RSTOBJ 
FileA |<«— File B 
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Figure 18. Restoring a Copy of a File 


file can be used during the restore operation, even through logical files. The file is 
exclusively locked during the restore operation. 


Comparing File Attributes during a Restore Operation 
When you restore a database file or member that exists on the system, the system 
expects the creation dates for the system copy and the media copy to be the same. 
If they are not the same, the system cannot ensure that the contents of the saved 
copy match the format of the copy on the system. 


If you specify ALWOBJDIF(*NONE) on the restore command, the system does not 
restore the file or member if the creation dates do not match. A message is sent to 
the user to indicate that the file or member could not be restored from the media. 
ALWOBJDIF(*NONE) is the default. 


The creation dates on the system and media might be different because: 
* A file or member was deleted and created again after the save operation. 


* The file or member on the media was created on another system, but it has the 
same name as an existing file or member. 


If you really want to restore a file or member whose creation date differs from the 

system version, you have three choices: 

* Delete the file or member from the system. Then restore. 

* Specify ALWOBJDIF (*FILELVL) on the restore command. This value lets you 
attempt to restore physical file data even though its creation date is different 
than the system copy creation date. 

* Specify ALWOBJDIF(*ALL) on the restore command. However, this can cause 


problems. You should be aware of what the system does when you specify 
ALWOBJDIF(*ALL). 


How the System Restores Database Files with ALWOBJDIF(*ALL): 


page 247| shows what the system does when creation dates for a database file are 
different on the system and media copies: 
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FILEA on the System 


FILEA 
940715 


FILEA/MBR1 | }——_—_» 


940715 


FILEA/MBR2 
940730 


FILEA on the Media 


FILEA 
940708 


FILEA/MBR1 | }——_» 


940708 


FILEA/MBR2 
940730 


Files on System after 
Restore Operation 


FILEA0001 
940715 


FILEA0001/MBR1 
940715 


FILEA0001/MBR2 
940730 


FILEA 
940708 


FILEA/MBR1 
940708 


FILEA/MBR2 
940730 
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Figure 19. Restoring Database Files with Different Creation Dates 


The file on the system is renamed. The media version is restored. A message is sent 


to the user. 


shows what the system does when the creation date for one of the 
members in the file is different: 


Files on System after 


FILEA on the System Restore Operation 
FILEA oo FILEA 
940715 940715 
FILEA/MBR1 | }———> FILEA/MBR1 
940715 940715 


FILEA/MBR2 | }——_» FILEA/MBR20001 
940730 940730 


>—>  FILEA/MBR2 


FILEA on the Media 940725 


FILEA 
940715 


FILEA/MBR1 
940715 


FILEA/MBR2 
940725 
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Figure 20. Restoring Database Files with Different Creation Dates 
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The member on the system is renamed. All members from the media are restored. 
A message is sent to the user. 


When you specify ALWOBJDIF(*ALL) and additional members are created during 
a restore operation, the system ignores the MAXMBRS (maximum members) 
parameter for the file. After the restore operation, you may have more than the 
allowed members in the file. 


If a logical file is associated with a file or member that is renamed, the logical file 
is still associated with the renamed file or member, not the restored member. 


In both examples, specifying ALWOBJDIF(*ALL) can result in duplicate 
information, additional files, and additional members. Your system becomes 
cluttered and your applications may produce unexpected results. If you specify 
ALWOBJDIF(*ALL), carefully check the messages you receive and analyze your 
files and members after the restore operation. 


Notes: 
1. The ALWOBJDIF parameter also affects object ownership. This is described in 


“How the System Establishes Ownership for Restored Objects” on page 226 
2. When you specify MBROPT(*MATCH) on a restore command, you cannot 
specify ALWOBJDIF(*ALL). See |“How the System Matches File Members 


How the System Matches File Members during a Restore 
Operation 


When you are restoring to an existing database file, you use the member option 
(MBROPT) parameter on either the RSTOBJ command or the RSTLIB command to 
tell the system what to do if the members do not match. The choices are: 


*MATCH 
If the set of members on the save media and on the database are not 
identical, the restore operation fails. *MATCH is the default. 


*ALL All members on the save media are restored, whether or not they exist on 
the system copy. 


*NEW Only those members on the save media that do not exist in the database 
file are restored. 


*OLD Only those members on the save media that already exist in the database 
file are restored. 


Note: The ALWOBJDIF parameter determines what the system does if creation 
dates on the members do not match. See |“Comparing File Attributes during 
a Restore Operation” on page 246 


Restoring Members to a File 


You can restore a list of members for a database file by using the FILEMBR 
parameter of the RSTOBJ command. This list may consist of specifically named 
members, generically named members, or a combination of both specifically and 
generically named members. 


The FILEMBR parameter is used to specify: 
* A list of file members (specific or generic) for a specific database file 
* The same group of members from more than one file 


248 0S/400 Backup and Recovery V5R2 


The default value *ALL causes all file members of files specified with the OBJ 
parameter to be restored. 


Restrictions on the File Member Parameter 

The following restrictions apply to the FILEMBR parameter: 

* Each database file that is specified in the FILEMBR parameter must also be 
specified in the OBJ parameter by its complete name, a generic name, or *ALL. 


¢ Generic names are not valid for the database file name. 
¢ Generic names are valid for the member name. 


If a generic file member name is used, and the file does not have members that 
fit the generic name, the file is not restored. If all files specified by the FILEMBR 
parameter are not restored, a diagnostic message is sent and the restore 
operation ends with an escape message giving the number of files not restored. 


If a name that is not generic is used, the specific members must exist in the file 
for any part of the file to be restored. 


¢ The OBJTYPE must be *ALL or include *FILE. 
* The MBROPT parameter must not have the *MATCH value. 


Restoring Logical Files 


When you restore a logical file, the system uses the description for the logical file 
to establish its relationship with the based-on physical files and logical files. All 
based-on files must exist before you can restore the logical file. 


You can restore a logical file to a library different than the library for the associated 
physical file. However, the associated physical file must remain in or be restored. to 
its original library location. 


If you try to restore a logical file to a library in which it does not exist, the restore 
operation fails if any of the associated physical files have had their storage freed. 


When a logical file is restored, it must be dependent on the same physical files as 
it was when it was saved. 


* The logical file is created over the physical files in the library where they are 
being restored if any of the following occur: 


— The logical file and the associated physical files existed in the same library at 
the time of the save operation. 


— The logical file and the associated physical files are present in the library 
where the files are being restored. 


— The logical file and the associated physical files are being restored to the same 
library. 
* If the files are not present in the restore library, then the logical files are created 
over the physical files in the original saved library. 


* If the correct physical files are not found in either library, then the restore 
operation of the logical file fails. To correct the problem, run the RSTOBJ 
command again and specify OBJ(*NEW). If the restore operation is successful, an 
informational message (CPF3291) is sent to indicate which library was used for 
associated physical files. 


The creation dates of the physical files must not have changed since the logical file 
was saved. If the date has changed, an informational message (CPF3293) is sent 
indicating that the physical file has been changed since the save operation, but the 
restore operation continues. 
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Restore physical or logical files with dependent logical files before the dependent 
logical files, unless the physical and logical files already exist on the system. The 
following considerations apply to restoring logical files: 


* If the dependent physical or logical files are in the same library, the system 
provides the proper sequencing. 


* If the files are in different libraries, you must restore the libraries in order, so 
that the physical or logical files that have logical files built on them are restored 
first. 


* If the depended-on physical or logical files are not restored before you attempt 
to restore the logical files, restoring the logical files fails. 


* This sequencing also applies to other requirements between files, such as shared 
formats. You can restore those logical files that failed by using the RSTOBJ 
command. 


How the System Restores Access Paths 


The description for a database file contains a description of its access path, if it has 
one. When you save a database file, you may save the access path with the file. 
This depends on the type of file, the type of access path, and how you performed 
the save operation. For more information, see the Backing up your system topic 
on the Information Center at the following Web site: 


http://www. ibm.com/eserver/iseries/infocenter 


When you restore a file, the system either restores the access path with the file or 
rebuilds the access path based on the information in the file description. The 
process of rebuilding the access path for a large database file can take a long time. 
This topic describes when the system restores access paths and when it cannot. If 
possible, you should plan your save operations to avoid having to rebuild access 
paths during a restore operation. 


The system always restores the access path for a keyed physical file of type *~DATA 
unless the access path was not saved. The access path for a keyed physical file is 
always saved, unless the access path is not valid at the time of the save. 


Normally, source physical files are not keyed. The default for the CRTSRCPF is to 
create a non-keyed file. When you restore a keyed source physical file, the access 
path is rebuilt after the restore operation. 


Access paths that are owned by logical files are restored if all of the following 
conditions are true: 


* The system saved the access path. Although this seems obvious, the system only 
saves access paths if the certain conditions are met. For more information, see 
the Backing up your system topic on the Information Center at the following 
Web site: 


http://www. ibm.com/eserver/iseries/infocenter 


* All based-on physical files are in the same library and are being restored at the 
same time on the same restore command. 


* If the logical file exists on the system, it does not specify MAINT(*REBLD). 
* The logical file owned the access path at the time it was saved. 


If the logical file is created again by the restore operation and it shares an access 
path that already exists, the key length for the access path must be equal to the 
maximum key length of the logical file or you receive an error. 
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If you meet these conditions, you minimize the rebuilding of access paths. 
However, during the restore operation, the system checks the integrity of each 
access path. If it detects any discrepancy, the access path is rebuilt. 


In a few cases, the system may decide to rebuild access paths even though they 
were saved. For example, you may have defined a new logical file that specified 
the same key as the physical file but also specified UNIQUE. The based-on 
physical file was in use at the time that the logical file was created. Therefore, the 
system had to create a new access path for the logical file. Assume that you save 
these two files with a single command. If you restore them with a single 
command, the system will determine that they can share a single access path. 
Instead of restoring the two access paths, it builds a new, shared access path for 
the two files. 


ne = ring a File Network—Examples 


Figure 21}shows a physical file and two logical files: 


LIB1/FILEA (Physical) LIB1/FILEB (Logical) 
Attributes Attributes 
Access Path Definition Access Path Definition 
;-—— Members Members 
| —_>MEMBER1 _. 
Attributes Attributes 
Data +———_{ Access Path 
Keyed Access Path 
——>MEMBER2 LIB2/FILEC (Logical) 
Attributes Attributes 
Access Path Definition 
Data < Members 
Keyed Access Path i 
MEMBER1 
Attributes 
Access Path 
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Figure 21. Restoring Access Paths 


Assume that these files were saved with this command: 
SAVLIB LIB(LIB1 LIB2) ACCPTH(*YES) 


The save media volume contains all three files (FILEA, FILEB, and FILEC) and 


three access paths, each owned by a different file.|Table 50 on page 252|shows what 


the system does when you restore these libraries by using different methods. These 
examples assume that none of the files are on the system when the system restores 
them: 
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Table 50. Restoring a File Network 


Sequence of Restore Commands 


What the System Does 


Example 1: 
1. RSTLIB SAVLIB(LIB1) 
2. RSTLIB SAVLIB(LIB2) 


Results of Example 1: 


1. FILEA and FILEB are restored. The access paths owned by 
FILEA and FILEB are restored. 


2. FILEC is restored. The access path owned by FILEC is 
rebuilt. 


Example 2: 
1. RSTLIB SAVLIB(LIB2) 
2. RSTLIB SAVLIB(LIB1) 


Results of Example 2. 
1. FILEC is not restored because FILEA is not on the system. 
2. FILEA and FILEB are restored. The access paths owned by 


FILEA and FILEB are restored. 


These examples highlight the problems that can occur when logical files and 
based-on physical files are in different libraries. Access paths are restored when 
physical files are restored because they are built over data that is contained in the 
physical file. In the first example, FILEC owned the access path but FILEC was not 
on the system when the physical file was restored. Therefore, the access path was 
not restored. In the second example, FILEC could not be restored because its 
based-on physical file (FILEA) was not on the system. 


How to Prevent the System from Rebuilding a Large Access Path 
If the situation that is shown in|Table 50}occurs on your system and you want to 
prevent the system from rebuilding a large access path, do the following: 


1. Restore the physical file or the library that contains the physical file. In the case 
of example 2, restore FILEA or LIB1. 


2. Restore the logical file (FILEC) using the RSTOBJ command. 


3. Immediately after restoring the logical file, type EDTRBDAP. You are shown the 
Edit Rebuild of Access Paths display. 


4. Change the value in the Seq column for the logical file to *HLD. 

5. Restore the physical file (FILEA) again using the RSTOBJ command. Because 
the logical file (FILEC) is now on the system, the system will restore the access 
path that is owned by FILEC. 

6. Type EDTRBDAP. You are shown the Edit Rebuild of Access Paths display. 


7. Change the sequence number for FILEC to a value from 1 through 99 to 
remove the access path from the display. 


How the System Restores Files with Shared Formats 


When a database file is restored and that file, before it was saved, had shared the 
record format of another file, an attempt is made to find the file whose format was 
shared, and reestablish the original format sharing. 


The search for restoring the shared format starts in the library to which the 
restored file is directed and continues in the library from which the restored file 
was saved. Following are the results of the search: 


* If the sharing file is found and has not been changed (level check) since the 
save, then no new format is created for the restored file. 


* If the sharing file is not found, or it is found but fails the level check, then a 
new format for the restored file is created with the same definition as the one it 
initially shared. 
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* If a format sharing file has been renamed, deleted, or moved to a library other 
than the save or restore library, a new format is created for the dependent file 
when the dependent file is restored. 


How the System Restores Files with Referential Constraints 


Information about DB2/400* database files is kept in system cross-reference files. 
This includes information about constraints that are defined. When you define a 
referential constraint, you specify that a record with a certain primary key must 
exist in the parent file before a record with the same values in a foreign key can 
exist in the dependent file. For example, you cannot add an order to the order file 
(dependent file) unless a record exists for the customer in the customer file (parent 
file). 


A referential constraint is defined, stored, and saved with the dependent file. Each 
referential constraint has a name, which must be unique for the library that 
contains the dependent file. When you restore a file that has a referential constraint 
name that already exists in the library, the system generates a new name for the 
referential constraint that is being restored. 


When you restore a database file that already exists on the system, the referential 
constraints that are defined for the system copy of the file are used. If the saved 
version of the file has additional referential constraints that are not on the system 
copy, these additional constraints are not restored. 


When you restore a database file that does not exist, you should ensure that any 
referential constraints that were not on the saved copy are reestablished. 
Otherwise, you lose the data integrity checking that was on your system before a 
failure occurred. 


Files that are related by referential constraints form a database network similar to 
the network formed by logical files and the based-on physical files. You should try 
to save an entire referential constraint network in one operation. If this is not 
possible, you should at least save the files with consecutive operations where no 
activity occurs in between. This ensures that the files are synchronized. 


If you journal database files, you should journal all physical files that are part of a 
referential constraint network. This ensures that your referential constraints remain 
valid after you have applied journaled changes. The Journal Management topic in 
the iSeries Information Center (http://www.ibm.com/eserver /iseries /infocenter) 
provides more information about journaling and referential constraints. 


Referential Constraint Network—Example 
Figure 22 on page 254}shows an example of a referential constraint network. 
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ORDER File COMPANY File 


Order Number Company Number 
(Primary Key) 


Customer Number 
(Foreign Key) 


Item Number CUSTOMER File 
(Foreign Key) 


Company Number 
Warehouse (Foreign Key) 
(Foreign Key) 


Customer Number 
“>| (Primary Key) 


INVENTORY File ITEM File 


Item Number + | |tem Number 
Warehouse Number} < >| (Primary Key) 
(Primary Key) 


Item Number 
(Foreign Key) 


RBANS519-0 


Figure 22. Restoring a Referential Constraint Network 


You can restore the files in this network in any sequence. When you restore the 
files, the system reestablishes the relationships and attempts to determine whether 
the constraints are still valid. 


For example, if you restore both the ITEM file and the INVENTORY file, the 
system checks the internal information stored with the files to determine whether 
the indexes for the two files are synchronized. 


If the internal information does not match, the system validates the constraint for 
the INVENTORY file. It does this by reading every record in the INVENTORY file 
and ensuring that a record with that item number exists in the ITEM file. If this 
process is successful, the constraint is valid. If this process is not successful, the 
status of the constraint is set to Check pending. When the status of a constraint is 
check pending, you must take action to correct the situation, either by restoring 
one of the files or using a program to update the files. 


If you restore one of the files, the system again attempts to validate the constraint. 
If you use a program to update the information, you must use the Edit Check 
Pending Constraints (EDTCPCST) command to force the system to revalidate the 
describes how to determine the status of files that have referential 
constraints. 


Look in the Information Center under the Database and File System topics for 
more information about using referential constraints. 


How the System Restores Files with Triggers 


You can define one or more trigger programs for a file. When a certain event 
occurs in the file, the system calls the trigger program. When you save a file that 
has trigger programs, you are saving only the definitions of the trigger programs, 
not the programs themselves. You must ensure that the programs are also saved, 
perhaps by placing them in the library with the file. 
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When you restore a database file that already exists, the system does not restore 
any trigger program definitions from the save media. When you restore a database 
file that does not exist, you should ensure that any definitions for trigger programs 
that were not on the saved copy are reestablished. Otherwise, you lose the data 
integrity checking that was on your system before a failure occurred. 


The system does not stop restoring a database file if its trigger programs cannot be 
found. Therefore, you must ensure that files and trigger programs are saved and 
restored correctly. Otherwise, an error may occur. 


‘Table 51|shows examples of actions the system takes when you restore the physical 
file FILEA and the trigger program PGMA: 


Table 51. Restoring Files That Have Trigger Programs 


How the Trigger Program Is 


Save Procedure That Is Restore Procedure That Is Defined after the Restore 

Used Used Operation 

FILEA is saved from LIBX. PGMA is restored to LIBY. The trigger is defined as 

PGMA is saved from FILEA is restored to LIBX. LIBX/PGMA. When an event 
LIBX. The trigger is occurs that causes this trigger, the 
defined as LIBX/PGMA. program will not be found. 
FILEA is saved from LIBX. PGMA is restored to LIBY. The trigger is defined as 

PGMA is saved from FILEA is restored to LIBY. LIBY/PGMA. 


LIBX. The trigger is 
defined as LIBX/PGMA. 


FILEA is saved from LIBX. PGMA is restored to LIBZ. The trigger is defined as 

PGMA is saved from LIBY. FILEA is restored to LIBZ. LIBY/PGMA. When an event 
The trigger is defined as occurs that causes this trigger, the 
LIBY /PGMA. program will not be found. 


Look in the Information Center under the Database and File System topics for 
more information about using trigger programs. The Journal Management topic in 
the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter 
describes special considerations when you journal database files that have triggers 
defined. You must make special provisions to ensure the integrity of your data 
because trigger programs are not called when you apply journaled changes. 


Steps Before Deleting a Physical File 


In some situations, you must delete a physical file as part of your recovery. For 
example, the physical file may be damaged. Or a physical file in a user ASP may 
have overflowed into the system ASP. You cannot delete a physical file if other files 
are dependent on it, such as logical files or files that share the record format. 


Before deleting a physical file, do the following: 


1. Use the Display Database Relationships (DSPDBR) command to list all the files 
that are dependent on the physical file. 


2. Save and delete each file that is dependent on the physical file. 


After you have recovered the physical file, restore all the dependent files. 
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Restoring Journals and Journal Receivers 


Note: If you are restoring remote journals or journal receivers that are associated 
with remote journals, refer to the Journal Management topic in the iSeries 
Information Center at http://www.ibm.com/eserver /iseries /infocenter. 


You can restore journals or journal receivers only to the same library from which 
they were saved. Use the RSTOBJ and RSTLIB commands to restore journals and 
journal receivers. When you are restoring multiple objects with one of these 
commands, journals and journaled objects are restored before the journal receivers. 


When you use several commands to restore several objects, restore the objects in 
this order: 


1. Journals 

Based-on physical files 

Other journaled objects associated with those journals 
Dependent logical files 


af won 


Journal receivers 


Note: Journal receivers can be restored at any time after the journals. They do 
not have to be restored after the journaled objects. 


If you have journal receivers that were created before V3R1, you must restore them 
in the order of newest to the oldest to establish the receiver chain correctly. 


Restoring Journals 


When you restore a journal, the system creates a new journal receiver and attaches 
it. The characteristics of the new journal receiver are based on the journal receiver 
that was attached when the journal was saved: 


* The system creates a name that is not likely to conflict with other journal 
receivers that may be on the system. The Journal Management topic in the 
iSeries Information Center (http: //www.ibm.com/eserver /iseries /infocenter) 
describes how the system generates a name. 


* The system attempts to assign the same owner and to create the journal receiver 
in the same library. If the owner of the receiver is not found, the receiver is 
assigned to the default owner (QDFTOWN) user profile. If the library is not 
found, the journal receiver is placed in the journal's library. 


* The system starts a new receiver chain. The Journal Management topic in the 
iSeries Information Center (http: //www.ibm.com/eserver /iseries /infocenter) 
discusses receiver chains. 


Note: At the time a new journal receiver is created and attached, private 
authorities have not been restored on the system. Therefore, private 
authorities will not be assumed by the new journal receiver. After the 
Restore Authority (RSTAUT) command is run, users will receive private 
authority to the receiver that was attached before the restore operation. 
Users will not receive private authority to the new receiver. Users must be 
manually granted private authority to the new receiver. 


You cannot restore a journal to a library that contains the same journal. If a journal 


must be restored (because of damage) to a library, the existing journal must be 
deleted first. 
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Steps before Deleting a Journal 


In some situations, you must delete a journal as part of your recovery. For 
example, the journal may be damaged. Or a journal in a basic ASP Nmay have 
overflowed into the system ASP. You cannot delete a journal while objects are 
being journaled to it. 


You use the Delete Journal (DLTJRN) command to delete a journal. Before deleting 
a journal, try to do the following steps. You may not be able to perform these steps 
successfully if the journal is damaged. 


1. Type 


WRKJRNA JRN(Library-name/journal-name) 
OUTPUT (*PRINT) 


and press the Enter key. You receive a listing that shows all the objects that are 
currently being journaled. 

2. End journaling for all the access paths assigned to the journal by typing: 
ENDJRNAP FILE(*ALL) 
JRN(library-name/journal-name) 

3. End journaling for all the physical files assigned to the journal by typing: 
ENDJRNPF FILE(*ALL) 
JRN(library-name/journal-name) 


4. End journaling for all the integrated file system objects assigned to the journal 
by typing: 
ENDJRN OBJ(*ALL) 
JRN(/QSYS.LIB/library-name.LIB/journal-name.JRN) 

5. End journaling for all other object types assigned to the journal by typing: 


ENDJRNOBJ OBJ(*ALL) OBJTYPE(*ALL) 
JRN(Library-name/journal-name) 

6. Deactivate any remote journals that are associated with the journal by using the 
Change Journal State (QjoChangeJournalState) API or the CHGRMTJRN 
command. 


When you try to delete the journal, you may receive message CPF7021 indicating 
that the journal is being used for commitment control. If this occurs, end the jobs 
that are using commitment control and then try to delete the journal again. To see 
the commitment control uses of the journal use the Work with Journal Atrributes 
(WRKJRNA) command, function key 19 (F19=Display journaled objects), and 
option 6 (6=Commitment Definitions). You can use the End Job (ENDJOB) 
command or you can use the End option from the Work with Active Jobs 
(WRKACTJOB) display. 


After you restore the journal or create it again, you must start journaling again for 
each object. Use the following commands to begin journaling for each object type 
listed below: 


* Database physical files — STRJRNPF 
* Access paths — STRJRNAP 

* IFS objects — STRJRN 

* All other object types — STRJRNOBJ 


You should save the objects after you start journaling, in case the system assigned 
a new journal identifier JID) to an object. If you previously had any remote 
journals associated with the journal, add them again by using the Add Remote 
Journal (ADDRMTJRN) command or the Add Remote Journal 


Chapter 10. How to Restore Specific Types of Information 257 


(QjoAddRemoteJournal) API. If you added any remote journals, you should save 
the journal in order to preserve that information. 


Restoring Journal Receivers 


If you have journal receivers that were created before V3R1, restore them from 
newest to oldest to establish the receiver chain correctly. If the journal receivers 
were created on V3R1 or later, you can restore them in any sequence. If you restore 
journal receivers in a single command, the system restores them in the correct 
sequence. 


The system will not restore a journal receiver over the journal receiver that is 
currently attached. The system will not restore a journal receiver over an existing 
journal receiver that contains more entries. If you use the SAVCHGOBJ command 
to save journal receivers, this is likely to occur. The journal receiver that is attached 
at the time of the save operation is a changed object and is saved by the command. 
When you restore, you receive message CPF3706 and the system continues with 
the next journal receiver. 


If your save procedure saves the currently attached journal receiver, you may try 
to restore a journal receiver with fewer entries than the journal receiver on the 
system. For example, assume that you save your journal receivers when receiver 
RCVR0006 is attached. RCVR0006 has 1500 entries. Later, you use the CHGJRN 
command to create and attach a new receiver. Now receiver RCVRO007 is attached. 
Receiver RCVRO006 is still on the system and has 4300 entries. If you attempt to 
restore receiver RCVRO0006 from your save media volume, the operation fails 
because the saved copy has only 1500 entries. 


If the library you specify on the restore command for a journal receiver does not 
exist, the system restores the journal receiver to the library that contains the 
journal. If you specify RSTASP(*SAVASP) and the ASP does not exist, the system 
usually restores the journal receiver to the same ASP as the library that contains 
the journal. 


Placing Journal Receivers in the Correct Auxiliary Storage Pool: If the attached 
journal receiver is not in the desired ASP after the restore operation, do the 
following: 


1. Create a journal receiver in the desired ASP. Follow your existing naming 
convention and use the same journal receiver attributes. 


2. Use the CHGJRN command to attach the new journal receiver to the journal. 


How to Resolve Name Conflicts When Restoring Journal 
Receivers 

When you restore a journal, the system creates and attaches a new journal receiver. 
The system attempts to name this journal receiver so that a name conflict does not 
occur. However, in rare cases, this new journal receiver may have a name that 
matches the name of a journal receiver that you need to restore. If this occurs, do 
the following: 


1. Create a new journal receiver with a name separate from your normal naming 
convention. For example, type: CRTURNRCV JRNRCV(library-name/TMP0001). 

2. Use the CHGJRN command to attach the temporary journal receiver: CHGJRN 
JRN(library-name/journal-name) JRNRCV(library-name/TMP0Q001). 

3. Delete the journal receiver that has the name conflict. This journal receiver 
should not have any entries you need for your recovery because it was created 
when the journal was restored. 
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4. Restore the journal receivers. 


5. Create a journal receiver that continues your naming convention and has the 
same journal receiver attributes. 


6. Use the CHGJRN command again to attach the journal receiver that you 
created in step|5 


How to Correct the Journal Receiver Directory 

Every journal has a directory of journal receivers. The sequence of journal receivers 
is called the receiver chain. Before you begin a recovery by using journal receivers, 
you should ensure that this receiver directory is current and correct. 


Do the following: 
1. Type WRKJRNA JRN(library-name/journal-name) and press the Enter key. 


2. From the Work with Journal Attributes display, press F15 (Work with receiver 
directory). You are shown the Work with Receiver Directory display. 


3. If the receiver directory is not correct, do the following: 
a. Type WRKJRN and press the Enter key. 
b. On the prompt display, enter the name of the journal. 


c. On the Work with Journals display, type a 9 (Associate receivers with 
journal) in the option column in front of the journal. The system establishes 
the receiver chain for the journal. 


Note: If some of the journal receivers were created prior to Version 3 Release 1, 
you may need to restore all the journal receivers, from newest to oldest, to 
establish the receiver chain correctly. 


Steps before Deleting a Journal Receiver 


In some situations, you must delete a journal receiver as part of your recovery. For 
example, the journal receiver may be damaged. Or a journal receiver in a user ASP 
may have overflowed into the system ASP. 


You cannot delete a journal receiver that is currently attached to a local journal. 
You also cannot delete a journal receiver if later journal receivers in the receiver 
chain are still on the system, unless one of the following conditions exists: 


* The receiver being deleted is damaged 
¢ The journal is a remote journal 


* The journal is system-managed 


If you need the journal receiver for recovery, you should not delete it without first 
saving it. If you do, the system warns you but does not prevent you from deleting 
the journal receiver. 


Before deleting a journal receiver, do the following: 

1. If the journal receiver is attached, detach it by typing: 
CHGJRN JRN(library-name/journal-name) 
JRNRCV (*GEN) 
Notes: 


a. If the current journal receiver is damaged, you cannot specify JRNRCV(*GEN). 
Use the Create Journal Receiver (CRTJRNRCV) command to create a new 
journal receiver that follows your naming convention and has the same 
attributes. Specify that receiver name on the CHGJRN command. 
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2. If earlier journal receivers are on the system, save them and delete them. You 
can print the receiver chain by typing WRKJRNA JRN(library-name/journal- 
name) OUTPUT (*PRINT). 


How the System Restores Programs 


Restoring programs to your system represents a security exposure. A restored 
program may have been altered to perform functions that you do not intend, or 
the program may adopt the authority of a powerful user profile. 


When the QSECURITY (security level) system value on your system is 40 or 
higher, the system checks for restricted instructions in all programs that are 
restored. You can use the QALWOBJRST system value to allow or prevent the 
restoration of certain types of objects on your system. You can also set the 


OQVFYOBJRST (verify eile on restore) system value to specify how_the system 
ifi -obj t d a restore operation. See |“Controlling 


In order for an object to be restored successfully, it must pass the three system 
values that work together during a restore operation: Verify object signatures 
during restore (QVFYOBJRST), Force conversion on restore (QFRCCVNRST) and 
Allow restore of security-sensitive objects (QALWOBJRST). However, if the Force 
object conversion (FRCOBJCVN) parameter on the restore command (RST) and 
Force conversion on restore (QFRCCVNRST) system value are not compatible, no 
conversion will occur and nothing is restored. To learn more about the 
compatibility of the FRCOBJCVN parameter and QFRCCVNRST system value, see 
Effects of system value settings on restore operations in the System Values topic of 
the iSeries Information Center at http: //www.ibm.com/eserver/iseries /infocenter. 


The system stores a validation value for all programs. When a program is restored, 
the system calculates the validation value and compares it to the value on the 
media. You can use the convert objects during restore (QFRCCNVRST) and allow 
restore of security sensitive objects (QALWOBJRST) system values to control the 
action to take when restoring programs with validation errors. You can choose to 
have the system recreate the program. If recreation is successful the program is 
restored and the validation error is corrected. If recreation is not successful the 
program is not restored. As an alternative, you can choose not to have the system 
attempt recreation and not allow any program with a validation error to be 
restored. A third alternative is to not attempt recreation and have the system 
restore the program with the validation error (which may be a security risk). The 
system contains all the information necessary to re-create an AS/400 or iSeries 
program. 


Restoring Programs to a Different Release 


Servers that run Version 3 Release 2 Modification 0 or earlier of the OS/400 
licensed programs are IMPI (internal microprogramming interface) processors. 
IMPI refers to the low-level instruction set and the Licensed Internal Code. iSeries 
or AS/400e processors that run V3R6 or higher of the OS/400 licensed programs 
are PowerPC® AS processors. When you move a program object (*MODULE, 
*PGM, *SRVPGM, *SQLPKG) between a system with an IMPI processor and a 
system with a PowerPC AS processor, the system must create the program object 
again from the information that is stored with the program. 


Object conversion occurs at one of the following times: 
* When the object is used for the first time. This is the default. 
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* When you use the Start Object Conversion (STROBJCVN) command to convert 
objects. This is normally done for an entire library. 


* When you restore the object. 


The AS/400 Road Map for Changing to PowerPC Technology has more information 
about moving from an IMPI system to a system with a PowerPC AS processor. 


Restoring OPM Program Objects 


If you create and save OPM (Original Program Model) programs on a system with 
a PowerPC AS processor and specify an IMPI target release, the objects are saved 
in a form that requires conversion when restored to either an IMPI or PowerPC AS 
system. 


Note: As of V5R1MO, you can no longer specify an IMPI target release. 


This conversion can take significant time, depending on the model and size of the 
system on which the objects are restored. OPM programs that are saved with a 
PowerPC AS target release, do not require conversion when restored to a PowerPC 
AS system. For these reasons, we recommend that you do not specify an IMPI 
target release for routine backups from a system with a PowerPC AS processor. 


If you are creating a single distribution medium for both IMPI and PowerPC AS 
systems, you might want to place two separate save files on the same distribution 
medium. The first save file would contain OPM programs that were saved with 
the IMPI target release. The second save file would contain the OPM files that 
were saved with the PowerPC AS target release. Files with the IMPI target release 
will still require conversion, but the files with the PowerPC AS target release can 
be restored to PowerPC AS systems without conversion. To avoid conversions for 
both IMPI and PowerPC AS restore operations, create the IMPI save file on an 
IMPI system and the PowerPC AS save file on a PowerPC AS system. 


Notes: 


1. These conversions are required because of significant differences between OPM 
objects on PowerPC AS systems and IMPI systems. 


2. ILE objects that are saved on a PowerPC AS system require no conversion 
when restored on a PowerPC AS system, even if they were saved with an IMPI 
target release. 


Restoring Save File Data 


You can save a save file to tape, optical media, or diskette with the SAVSAVFDTA 
command. When you restore the save file, it appears as though the data originally 
came from the same type of save media. You can use the RSTOBJ, RSTLIB, RST, 
RSTDLO, RSTCFG, or RSTUSRPRF commands to restore the data. 


You can save file data to tape, optical media, or diskette by using the SAVLIB, 
SAVOBJ, or SAVCHGOBJ commands. If you specified SAVFDTA(*YES) on the save 
command, you must restore the save file before you can restore the objects in the 
save file. 
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Restoring Spooled Output Files 


You cannot directly save and restore spooled files on an output queue. If you use 
the technique described in the Backing up your system topic in the Information 
Center at the following Web site: http://www.ibm.com/eserver/iseries /infocenter, 
you can restore the spooled files by first restoring the database files with a restore 
command, such as Restore Object (RSTOBJ) or Restore Library (RSTLIB), and then 
copy the database file members to the spooled output files by using the Copy File 
(CPYF) command and specifying TOFILE(QSYSPRT). 


Restoring Licensed Programs 


Use the RSTLICPGM command to add or replace licensed programs on the system. 
Refer to the Software Installation book for more information about installing licensed 
programs. 


Restoring Documents and Folders 


Use the Restore Document Library Object (RSTDLO) command to restore 
documents, folders, and mail. To use this command most efficiently, you should 
know how documents were saved. To determine this, use the output that was 
printed for the SAVDLO procedures, the DSPTAP command, or the DSPOPT 
command. RSTDLO performance is also better if you have *SAVSYS special 
authority. 


RSTDLO Command Options 


The RSTDLO command provides many options. You can restore any of the 
following: 


* A specific document or system object whose name you specify. 


* All the documents and folders you saved by typing: RSTDLO DLO(*ALL) 
SAVFLR(*ANY). If you saved DLOs from more than one ASP, you must specify 
SAVASP(*ANY). You must also specify the sequence numbers (SEQNBR parameter) 
for the files on the save media. 


Note: When you use RSTDLO DLO(*ALL), this includes the folders that are 
used by IBM-supplied programs, such as iSeries Access. Ensure that you 
saved these folders from the current release, or you may need to install 
the licensed programs again. 


* 1 to 300 documents from the same media file by specifying the names of the 
documents or the system object names. 


* 1 to 300 folders from the same media file. 
* All filed documents that are not in any folder on the save media. See|’Restoring| 


Folders” on page 264] for more information. 


Using Multiple Concurrent DLO commands 


Multiple concurrent SAVDLO or RSTDLO commands may be used in specific 
situations. 


No two of the following commands may be run on one system at the same time: 
* RCLDLO DLO(*ALL) 

* RCLDLO DLO(*DOCDTL) 

* RCLDLO DLO(*INT) 
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* DLTDLO DLO(*ALL) 
* RNMDIRE 


An attempt to run these commands at the same time results in the message 
CPF8A47: Internal system objects are in use. An attempt to run a SAVDLO or 
RSTDLO operation while one of these commands is running will also result in 
MSGCPF8A47 and no objects will be saved or restored. 


Output from the RSTDLO Command 


You can use the OUTPUT parameter on the RSTDLO command to show 
information about the restored documents, folders, and mail. You can either print 
the output (OUTPUT(*PRINT)) or save it to a database file (QUTPUT(*OUTFILE)). 


If you print the output, you should be aware of device dependencies: 


* The heading information in the output is device-dependent. All information does 
not appear for all devices. 


* The print file for the RSTDLO command uses a character identifier (CHRID) of 
697 500. If the printer you are using does not support this character identifier, 
you will receive message CPA3388. To print the RSTDLO output and not receive 
message CPA3388, specify the following before specifying *PRINT on the 
RSTDLO command: 


CHGPRTF FILE(QSYSOPR/QPRSTDLO) CHRID(*DEV) 


For more information about character identifiers (CHRID), see the Printer Device 
Programming book. 


If you use an output file, the system uses the file format 
OSYS/QAOJRSTO.OJRDLO. The file layout is described in the Office Services 
Concepts and Programmer’s Guide book. 


Considerations and Restrictions 


You should be aware of the following additional factors when using the RSTDLO 
command. 


Moving Documents 

When you restore documents, you can rename them, restore them to a different 
folder, or have the system assign new system object names. The folder for a 
document determines its ASP location. You can move a document to a different 
ASP by doing the following: 


1. Save the document. 
2. Delete it with the DLTDLO command. 
3. Restore it into a folder in a different ASP. 


Searching Tape Files 

When you restore documents or folders from a list and specify 
SEQNBR(*SEARCH), the system restores from the first tape file that contains any 
of the documents or folders that you specified. If the tape file does not contain all 
the documents and folders in your list, the system does not search other tape files 
for the additional documents and folders. You can specify SEQNBR(starting- 
sequence ending-sequence) to search more than one tape file. 


Selecting files from DVD-RAM optical media 


The OPTFILE and SAVASP parameters control which file(or files) that the system 
uses. If you specify a file pathname, the system uses that file. If you specify the 
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default of OPTFILE(’*’) or OPTFILE(‘directory-path-name/*’), the system uses files 
named QDOC or QDOCnnnn in the directory that you specify, depending on the 
SAVASP value. 


Search Index Database Errors 

When you restore DLOs, the system updates the search index database information 
for the DLOs. If you receive error messages during the restore procedure because 
the information in the database does not match the DLOs, run the Reclaim 
Document Library Object (RCLDLO) command. Then try the restore procedure 
again. 


Note: The message tells you if the RCLDLO procedure is necessary. Use RCLDLO 
only if you are instructed by a message or by the recovery checklist you are 
using. 


Authority Required to Restore DLOs 

If you are restoring DLOs into a folder, you must have authority to the folder. If 
you are restoring existing DLOs, you must have authority to those DLOs. Certain 
combinations of the RSTDLO command require additional authority. The iSeries 
Security Reference book provides information about the specific authorities that are 
required for the RSTDLO command. 


How the System Restores New DLOs 
When you restore new DLOs, the system files them. The DLO is treated as new to 
the system if any of the following is true: 


* It has been previously deleted. 
* It is being restored to a different system. 
* It is being restored with the NEWOBJ](*NEW) parameter. 


How the System Restores Existing DLOs 
When you are restoring an existing DLO, the system skips the DLO and continues 
with the next one if either of the following is true: 


* The DLO is in use. 
* You do not have the necessary authority. 


If the existing document is damaged, some of the security information may be lost. 
The restore operation continues and a message is sent informing you that the 
document is damaged and some of the security information is lost. 


Size Limitations When Restoring Document Library Objects 

On V2R3 or later, you cannot restore more than 349 000 objects to a single library. 
Before V2R3, the limit is 250 000 objects from a single library. Because DLOs are 
nominally stored in libraries, this limit applies to the QDOC library in the system 
ASP and to the QDOCnnnn libraries in user ASPs. 


Restoring Folders 


To restore a folder object, the entire folder (the folder object plus all document and 
folder objects within it) must also be restored. However, if the specific folder being 
restored was stored in other folders at the time it was saved, those higher level 
folders do not have to be restored to restore the specific folder. 


When you restore a folder, the fully qualified folder path name you are restoring 
must exist unless you are restoring a first-level folder. For example, if you save 
folder A and then delete it, you can enter RSTDLO DLO(*ALL) SAVFLR(A) and 
restore folder A in addition to all the documents and folders in it. However, if you 
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want to restore folder A/B/C/D, you must create folder A, then folder B in folder 
A, then folder C in folder A/B, before you can restore folder D in folder C. You 
only have to create the folders that comprise the A/B/C path, and you do not 
have to create folder D in folder A/B/C before you can restore it. 


If you try to restore a folder that is in use, the system bypasses restoring the folder 
and all the DLOs in it. 


If you try to restore into an existing folder but the folder is damaged and cannot 
be reclaimed, you receive a message informing you that the folder is damaged and 
not restored. The folder and all documents and folders in it are not restored. 


Renaming Documents When Restoring 


You can use the RENAME parameter to give documents a different name when 
they are restored. You can also place them in a different folder by using the 
RSTFLR parameter. 


If renaming a document when it is restored would result in a duplicate name in a 
folder, the system does the following: 


° If ALWOBJDIF(*NONE) is specified, the document is not restored. 


° If ALWOBJDIF(*ALL) is specified, the document is restored and replaces the 
existing document in the folder. 


You can specify more than one value for the RENAME parameter. The system 
matches the RENAME values with the DLO values until it runs out of values for 
one or the other. Assume that you specify: 


RSTDLO DLO(A B C D) SAVFLR(X) RENAME(J K L) RSTFLR(Y) 


After the restore operation, you would have these documents: 
* Document J in folder Y 

¢ Document K in folder Y 

¢ Document L in folder Y 

¢ Document D in folder Y 


Restoring OfficeVision/400 Mail and Distribution Objects 


You can restore OfficeVision/400 mail by specifying RSTDLO DLO(*MAIL). If you 
specified SAVDLO DLO(*MAIL) when you saved, you can specify RSTDLO DLO(*ALL) 
SAVFLR(*ANY) to restore OV/400 mail. 


Specifying RSTDLO DLO(*MAIL) restores only those filed documents that have a 
OV/400 mail log reference at the time they are saved. This also saves the 
distribution objects and distribution documents from the save media or online save 
file. Specifying RSTDLO DLO(*ALL) SAVFLR(*ANY) restores all distribution 
objects, all documents, and all folders from the save media or online save file. 


Distribution documents and objects cannot be restored individually. If you specify 
any other form of the RSTDLO command, such as RSTDLO DLO(*ALL) 
SAVFLR(A) and RSTDLO DLO(X) SAVFLR(A/B), then no distribution documents 
and objects are restored. If you restore the filed documents using these other forms 
of the RSTDLO command that contain OV/400 mail log references, then the 
OV/400 mail log references are restored if the distribution objects exist on the 
system. 
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Mail log references are updated for all existing local recipients of a restored 
document. Mail log references on remote systems for remote recipients are not 
restored. If a document being restored still exists in a mail log at the time it is 
restored, then the contents of the document are restored and the status of the 
document in the mail log is not changed. If the document being restored has been 
deleted from a mail log, then the status of the restored document is either filed for 
a filed document or opened for a distribution document. 


OV/400 mail log references are restored for a local sender of a document if there 
was an entry in the sender’s mail log at the time the distributions were saved. 
Entries in the OV/400 mail logs of remote senders are not saved or restored. 


How the System Restores Descriptive Information for DLOs 


The creation date, file date, and revision date for restored documents and folders 

are set as follows: 

* The creation date of the document or folder on the save media is restored with 
the document or folder. 

* When the RSTDLO command replaces a document or folder, the file date of the 
document or folder being replaced on the system is used. 

* The object revision date is set to the current date when the document or folder is 
restored. 

* The content revision date of the document on the save media is restored with 
the document. 

* The content revision date is set to the current date when replacing a folder. 


¢ The content revision date of the folder on the save media is restored with the 
folder if the folder is new. 


How the System Restores Authority and Ownership for DLOs 
“How the System Establishes Ownership for Restored Objects” on page 226] and 
“Restoring Object Authorities” on page 227|describe how the system handles 
ownership and authority when restoring objects. These same rules apply when 
restoring DLOs, with these additions: 


* If the user profile that owns a DLO is not in the system distribution directory, 
ownership is assigned to the QDFTOWN user profile. 


* When you restore a DLO that does not exist on the system, any access codes and 
explicit users are removed. If you have restored user profiles and you later run 
the RSTAUT command, the private authorities to the DLO are restored. The 
access codes are not restored. 


When to Run the Rename Directory (RNMDIRE) Command 


When you need to run the Rename Directory Entry (RNMDIRE) command for a 
local user, schedule it just before you perform the following operations: 


* Saving mail 

* Saving the system distribution directory 

If the rename operation is performed just before saving the mail and the directory, 
the changed information is saved and the information will be the same as what is 


on the system. If the information on the media does not match the information on 
the system, the mail will not be restored during the restore operation. 
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When to Run the Rename Document Library Object (RNMDLO) 
Command 


When you need to run the Rename Document Library Object (RNMDLO) 
command, schedule it just before you back up document library objects. If the 
rename operation is performed just before saving the document library object, the 
changed name is saved and the information on the media will be the same as what 
is on the system. 


If you rename a document library object after a save operation, the document 
library object name on the system is different than the name on the media. 
However, the system object names remain the same. The restore operation fails 
because the system thinks that the document library object already exists. Message 
CPF90A3 or CPF909C is sent indicating that the document or folder already exists. 


Do one of the following: 
* To create a new document or folder, specify NEWOBJ(*NEW). 
* To replace an existing document, specify RENAME(document-name), where 


document-name is the name that is given to the document by the RNMDLO 
command. 


* To replace an existing folder, specify RSTFLR(folder-name), where folder-name is 
the name that is given to the folder by the RNMDLO command. 


Recovery of Text Index Files for Text Search Services 


The text index database files are a part of the Text Search Services. The text index 
recovery process must ensure that a consistent, usable set of index files. The text 
search index contents must be consistent with the document library contents. The 
last version indexed date for all documents is recorded in both the text index and 
the individual documents. The dates are used in the recovery process to ensure 
that the text index and the document library content match. 


The text index database files are saved when library QUSRSYS is saved. A list of 
the files that are saved when library QUSRSYS is saved is shown in a table in the 
Office Services Concepts and Programmer's Guide book. 


If you are restoring the text index files, then all of the files must be restored 
together from the same backup media. If they are not restored from the same 
media, their association to each other is lost. The loss of the association to each 
other can cause unpredictable results. If you do not have saved copies of the files, 
you must delete the files and then restore them from your distribution media. 


The text index details are kept in the administration table file. Pointers to the 
current index are stored in the table. The administration table file must be restored 
with the other files. If you have changed the defaults for the text index details, 
then before restoring the files, write down the current text index details (if 
available). To display the text index details, type WRKTXTIDX on a command line and 
press the Enter key. Then select option 5 (Display details) on the Work with Text 
Index display. You can enter the values again after the table is restored. 


If the scheduling queue (file QABBIQTB) is damaged and there are documents on 
the system, you can restore the scheduling queue and can get back some of the 
requests that were lost if the saved scheduling queue is a very recent copy. 
Retaining the requests on the restored scheduling queue may not be a benefit if it 
is not a recent copy. 
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If you recover all text index search files, and documents from the same set of save 
media, you should not have problems. If you recover your system in pieces, 
consult[Appendix C, "Procedures for Recovering the Text Index’ for possible 
problems and their solutions. 


For more information about Text Search Services, see the Office Services Concepts 
and Programmer’s Guide. 


Restoring Objects in Directories 


Use the RST (Restore) command to restore objects that you have saved with the 
SAV command. These commands are most commonly used to save and restore 
objects the QNTC file system, the QOpenSys file system, and the Root file system. 


; Attention! 
If you have related objects, such as journals and journaled objects, you must 
ensure that you restore them in the correct sequence. Read) Gequetce for 


If you are restoring to a different system, specify ALWOBJDIF(*ALL) when 
you are restoring directories. 


You can use the RST command to restore: 
* A specific object 

* A directory or subdirectory 

* An entire file system 

* Objects that meet search criteria 

* A list of object path names 


You can also restore the items in the preceding list by using the QsrRestore API. 
For more information, look in the Information Center under the Programming 
topic at the following Web site: http://www.ibm.com/eserver/iseries /infocenter. 


For example, to restore all objects (or changed objects) in directories, use the 
following: 


RST DEV('/QSYS.LIB/media-device-name .DEVD') 
OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT)) 


Note: This example is the same restore (RST) command that is issued under option 
21 on the Restore menu. If you accept the default parameters on this 
command, the Restore Authority (RSTAUT) command will be run at the end 
of the restore procedures. 


You can rename an object or restore it to a different directory by using the 
new-name element of the object (OBJ) parameter. 


The OBJ parameter on the RST command supports the use of wildcard characters 
and the directory hierarchy. For more information about how to specify object 
names when you use integrated file system commands, look at the Information 
Center at the following Web site: 


http://www. ibm.com/eserver/iseries/infocenter. 
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Some file systems allow you to name the same physical object different ways by 
using aliases and links. For examples of objects with links and how those objects 
are saved, go to the Backing up your system topic on the Information Center. 


In the example of|Figure 23} FILEA in the JCHDIR directory and FILEB in the 
DRHDIR directory are both hard links to the same file. They point to the same 
object. They can have the same name or different names for the objects. 


Root 
UserDir 
v v 
JCHDIR DRHDIR 
v v 
FILEA FILEB 


—p| ObjectA \< 


RBANS520-0 
Figure 23. An Object with Hard Links—Example 
[Table 52} shows several examples of how the system restores these objects. These 


examples assume that you use this SAV command: SAV 0BJ('/UserDir/*'). The 
media volume contains OBJECT A and both hard links that point to the object. 


Table 52. Restoring Objects That Have Hard Links 


Objects That Are on the 
System before the RST 


Object Parameter on RST Command Command Objects after the RST Command 


RST OBJ('/UserDir/*') 


JCHDIR/FILEA The saved data is restored. The object 
DRHDIR/FILEB is created on the 
system. It points to the same object as 
JCHDIR/FILEA. 


RST OBJ('/UserDir/DRHDIR/*') JCHDIR/FILEA A new object, DRHDIR/FILEB, is 


created. The JCHDIR/FILEA that exists 
on the system is not affected by the 
restore operation. 


OBJ('/UserDir/*'), or JCHDIR/FILEA, Data from the media copy of FILEA 
OBJ('/UserDir/JCHDIR/*'), or DRHDIR/FILEB and FILEB is restored over the system 
OBJ('/UserDir/DRHDIR/*') copy because the same name is 


specified as a name that already exists 
on the system. 


Figure 24 on page 270|shows the symbolic link called customer that points in the 


CUSTLIB library. 
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Root 


¥ : 
QSYS.LIB customer 
Vv /QSYS.LIB/CUSTLIB.LIB 
CUSTLIB.LIB /CUSTMAS.FILE 
v 
CUSTMAS.FILE ¢_! 


RBANSS06-0 


Figure 24. An Object with a Symbolic Link-Example 


If you restore the customer object (RST OBJ('/customer')), you are restoring only 
the fact that it points to the CUSTMAS file, not the file itself. If the CUSTMAS file 
does not exist, the restore operation succeeds. However, if you try to use the 
customer object, you receive an error message. If you restore the CUSTMAS file or 
create it again, the symbolic link between customer and the CUSTMAS file is 
re-established. 


Completing Recovery for the iSeries Integration for Windows Server 
Product 


Recovery for save performed with Integrated xSeries Server 
varied off 


If you completely saved your directories with the Integrated xSeries Server varied 

off, your system restores Windows server on iSeries data. You need to perform the 

following steps to complete the recovery of these products: 

1. To add the links for the server descriptions, type the following for each server 
description: 


ADDNWSSTGL NWSSTG(Storage_Name) 
NWSD(Server_Description) 


2. Vary on your Integrated xSeries Servers by typing WRKCFGSTS *NWS and selecting 
option 1 to vary on each Integrated xSeries Server. 


Note: If you saved the Server Storage space beneath QFPNWSSTG (by using the 
command SAV 0BJ('/QFPNWSSTG/Server_Storage'), you must create the 
QFPNWSSTG first. Create /QFPNWSSTG by performing the following 
steps: 

1. Create the server storage by using the CRTNWSSTG command. 
2. RST OBJ(’/QFPNWSSTG/Server_Storage’) 

3. Add the storage link by using the ADDNWSSTGL command. 

4 


. Vary on the Integrated xSeries Server by typing WRKCFGSTS *NWS and 
selecting option 1 to vary on. 


Recovery for save performed with Integrated xSeries Server 
varied on 
Perform the following steps for Windows server on iSeries: 


1. If you have any Integrated xSeries Servers that are varied on, vary them off by 
using the WRKCFGSTS *NWS command and selecting option 2. 


2. Create any needed Network Storages by using the CRTNWSSTG command. 
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3. Add the storage links by using the ADDNWSSTGL command. 
4. Vary on your Integrated xSeries Servers by using the WRKCFGSTS *NWS 
command and selecting option 1. 


5. Restore the Windows server data by typing RST 0BJ('/QNTC') and press the 
Enter key. 


Recovering Linux in a Partition 


If you completely saved your directories with the network server description 
(NWSD) for Linux varied off, your system restores Linux data. You need to 
perform the following steps to complete the recovery of Linux: 
1. To add the links for the server descriptions, type the following for each server 
description: 
ADDNWSSTGL NWSSTG(Storage_Name) 
NWSD(Server_Description) 
2. Vary on your NWSD for Linux by typing WRKCFGSTS *NWS and selecting option 
1 to vary on each NWSD for Linux. 


Note: If you saved the Server Storage space beneath QFPNWSSTG (by using the 
command SAV 0BJ('/QFPNWSSTG/Server_Storage'), you must create the 
QFPNWSSTG first. Create /QFPNWSSTG by performing the following 
steps: 

1. Create the server storage by using the CRTNWSSTG command. 
2. RST OBJ(’/QFPNWSSTG/Server_Storage’) 

3. Add the storage link by using the ADDNWSSTGL command. 

4 


. Vary on the NWSD for Linux by typing WRKCFGSTS *NWS and selecting 
option 1 to vary on. 


Note: Linux (*“GUEST) NWSDs that use an NWSSTG as the IPL source 
(IPLSRC(*NWSSTG)) or use a stream file as the IPL source (IPLSRC(*STMF)) 
will be fully saved and restored using Option 21. *GUEST NWSDs that use 
IPLSRC(A), IPLSRC(B), or IPLSRC(PANEL) will NOT be able to start on a 
system restored from an Option 21 save and will require additional actions, 
such as booting Linux from the original installation media, to be recovered. 


Recovery Steps for OS/400 Enhanced Integration for Novell 
NetWare 


OS/400 Enhanced Integration for Novell NetWare runs on a remote server. Your 
iSeries server communicates with the remote server through /QNetWare, but it 
saves all of the Netware data on remote server storage. 


The previous OS/400 Integration for Novell NetWare ran on an Integrated xSeries 
Server which meant that you restored both the /QNetWare subdirectory and 
Netware server storage when you restored your server. 


Since the new OS/400 Enhanced Integration for Novell NetWare product does not 
store any data on your server, you have two backup options. First, you can easily 
backup the /QNetWare subdirectory and restore the /QNetWare subdirectory with 
your server in a restricted state or a non-restricted state. 


Your second option is to restore your server to the point that you can start your 


network descriptions and save the data from your remote Netware server through 
/QNetWare. This is very slow, however. 
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A better choice is to consider your remote server like a personal computer 
workstation and save the Netware data with workstation backup software. You can 
save the remote directories on your Netware Server with ARCserve or SBACKup 
utilities after you vary the Integrated xSeries Server on. 


Refer to the ARCserve or SBACKup documentation for the recovery steps. 
For additional information about recovering your NetWare environment, refer to 


the Information Center at the following Web site: 
http:/ /www.ibm.com/eserver /iseries /infocenter. 


Recovering a Domino” Server 


The Domino product resides in libraries in the QSYS.LIB file system on your 
server. All of your Domino databases reside in the integrated file system in a 
directory path that you specify when you configure your server. Your backup 
strategy for your Domino server should include saving both the libraries 
(infrequently) and the database directories (frequently). 


You might need to recover Domino for a variety of reasons, for example: 

* Damage to your server, such as fire or flooding 

* Hardware problems, such as a disk failure 

* User or operator error, such as deleting a database or running a month-end 
procedure twice. 


Sometimes, you must recover your entire server. Other times, you must restore a 
specific directory. The following topics provide general information about recovery 
procedures for Domino. 


° |“Recovering an entire Domino server” 


° |“Recovering Domino mail” on page 273 


* |“Recovering specific Domino databases” on page 273) 


: estoringe changed objects to a Domino server” on page 
“Restoring changed objects to a D g se 274 


Recovering an entire Domino server 


If you are faced with a system disaster, such as a site loss or the failure of an 
unprotected disk unit, you must recover (restore) your entire server from a backup. 
Because the iSeries and AS/400e servers are highly integrated systems, you must 
restore objects in the correct sequence to rebuild the proper links between objects. 
Consult other parts of this book for complete instructions for performing a full 
system recovery. 


If you are faced with a problem that requires restoring only your Domino server, 
you can use the Restore (RST) command to restore your Domino directories from 
save media. Following is an example of the steps. 


Example 


1. Start an iSeries session with a user profile that has *JOBCTL and *SAVSYS 
special authorities. 


2. To ensure that no one is using the server that you plan to restore, stop the 
server. Use the End Domino Server (ENDDOMSVR) command. 


3. Mount the media volume that has the most recent backup copy of the 
directories for the server. 
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4. Type the appropriate restore (RST) command for your Domino directory. For 
example, if your Domino directory is /NOTES/DATA, type the following 
command: 


RST DEV('/QSYS.LIB/media-device-name.DEVD') 
OBJ('/NOTES/DATA/«' ) 


Note: Consult your Domino documentation for any special recovery activities that 
you might need to perform after you have restored the directories. 


Recovering Domino mail 


If you need to recover one or more mail databases from your backup save media, 

use the Restore (RST) command. Following is an example of the steps: 

1. Start an iSeries session with a user profile that has *JOBCTL and *SAVSYS 
special authorities. 

2. Stop the server that contains the mail databases that you want to restore. Use 
the End Domino Server (ENDDOMSVR) command. 


3. Mount the media volume that has the most recent backup of the mail 
databases. 


4. Type the appropriate Restore (RST) command for the mail databases that you 
want to restore. For example, to restore all the databases to the MAIL 
subdirectory, type the following command: 


RST DEV('/QSYS.LIB/media-device-name.DEVD') 
OBJ ('/NOTES/DATA/MAIL/*') 


Examples 

* The name of a user’s mail database is usually the user’s ID (short name) with 
the .NSF extension. (The Domino administrator has the option to use different 
names for mail database files.) To restore a specific user’s mail database, such as 
the mail database for user GNELSON, use the following command: 
RST DEV('/QSYS.LIB/media-device-name .DEVD') 

OBJ ('/NOTES/DATA/MAIL/GNELSON.NSF' ) 

* You can specify more than one file on the restore command. To restore mail 

databases for GNELSON, LSMITH, and JPETERS, use the following command: 


RST DEV('/QSYS.LIB/media-device-name .DEVD') 
OBJ (('/NOTES/DATA/MAIL/GNELSON.NSF') 
('/NOTES/DATA/MAIL/LSMITH.NSF') 
('/NOTES/DATA/MAIL/JPETERS .NSF')) 
Notes" about the examples: 


1. All of the examples assume that the directory for your Domino server is 
/NOTES/DATA. 


2. You cannot restore over a database that is in use. All users must close the 
database before you can restore a backup copy. 


3. Consult your Domino documentation for any special recovery activities that 
you might need to perform after you have restored Domino mail. 


Recovering specific Domino databases 


You might need to restore a specific Domino database or a group of databases. Use 
the Restore (RST) command. Following is an example of the steps for restoring all 
the files to the HRDPT subdirectory: 


1. Start an iSeries session with a user profile that has *JOBCTL and *SAVSYS 
special authorities. 
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2. Stop the server that contains the databases that you want to restore. Use the 
End Domino Server (ENDDOMSVR) command. (You can restore a database 
when the server is running. However, you need to make sure that no one is 
using the database. Stopping the server is the best way to ensure that no one is 
using the database.) 


3. Mount the media volume that has the most recent backup of the databases. 

4. Type the appropriate Restore (RST) command for the mail files that you want 
to restore. For example, to restore all the files to the MAIL subdirectory, type 
the following command: 


RST DEV('/QSYS.LIB/media-device-name .DEVD') 
OBJ ('/NOTES/DATA/HRDPT/*.NSF') 


Examples 
* To restore a specific database that is named HRINFO to the HRDPT subdirectory 
(folder), type the following: 
RST DEV('/QSYS.LIB/media-device-name.DEVD') 
OBJ ('/NOTES/DATA/HRDPT/HRINFO.NSF') 
* To restore all the Domino databases to the CUSTSVC subdirectory, type the 
following: 
RST DEV('/QSYS.LIB/media-device-name.DEVD') 
OBJ ('/NOTES/DATA/CUSTSVC/*.NSF') 
* To restore all the Domino databases whose name begins with INV to the main 
directory for your server, type the following: 
RST DEV('/QSYS.LIB/media-device-name.DEVD') 
OBJ ('/NOTES/DATA/INV*.NSF') 


Notes about the examples: 


1. All of the examples assume that the directory for your Domino server is 
/NOTES/DATA. 


2. You cannot restore over a database that is in use. All users must close the 
database before you can restore a backup copy. 


3. Consult your Domino documentation for any special recovery activities that 
you might need to perform after you have restored a Domino database. 


Restoring changed objects to a Domino server 


To reduce the length of your backup window, your save strategy might include 
saving only changed objects from your Domino during the business week. When 
you need to use this save media to recover, you must decide your recovery 
sequence and determine the location of the most recent copy of each database. 
Following are examples of different recovery scenarios and an overview of the 
recovery steps for each. 


Example: Restoring changed Domino objects from a cumulative 
backup 

Assume that your strategy for saving changed objects is cumulative (each night 
you save everything that changed since the last complete backup). To recover your 
entire Domino directory, do the following: 


1. Start an iSeries session with a user profile that has *JOBCTL and *SAVSYS 
special authorities. 


2. To ensure that no one is using the databases, stop the Domino server. Use the 
End Domino Server (ENDDOMSVR) command. 


3. Locate the save media from your most recent complete backup. Mount the 
correct media volume in the save device. 
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4. 


To restore the entire Domino database directory, use the Restore (RST) 
command. For example, 


RST DEV('/QSYS.LIB/media-device-name .DEVD') 
OBJ ('/NOTES/DATA/«' ) 


Locate your most recent save media (from saving changed objects). 
To restore all the objects on the save media (everything that has changed since 
your full backup), type the following: 


RST DEV('/QSYS.LIB/media-device-name.DEVD') 
OBJ('/NOTES/DATA/«' ) 


Notes about the example: 


1: 


All of the examples assume that the directory for your Domino server is 
/NOTES/DATA. 

You cannot restore over a database that is in use. All users must close the 
database before you can restore a backup copy. 

Consult your Domino documentation for any special recovery activities that 
you might need to perform after you have restored a Domino database. 


Example: Restoring changed Domino objects from a nightly 
backup 

Assume that your strategy for saving changed objects is nightly (each night you 
save only objects that changed since the previous night). To recover your entire 
Domino directory, do the following: 


1. 


Start an iSeries session with a user profile that has *JOBCTL and *SAVSYS 
special authorities. 


To ensure that no one is using the databases, stop the Domino server. Use the 
End Domino Server (ENDDOMSVR) command. 


Locate the save media from your most recent complete backup. Mount the 
correct media volume in the save device. 


To restore the entire Domino database directory, use the Restore (RST) 
command. For example, 
RST DEV('/QSYS.LIB/media-device-name.DEVD') 

OBJ ('/NOTES/DATA/*') 
Locate your first save media volume (from saving changed objects). For 
example, if you save everything on Saturday night, locate your save media 
from Sunday night. 


To restore all the objects on the save media (everything that has changed since 
the previous night), type the following: 
RST DEV('/QSYS.LIB/media-device-name.DEVD') 

OBJ ('/NOTES/DATA/*') 
Repeat steps [5Jand (6]for each nightly save media until your directory is 
current. For example, if you are restoring on Thursday, you will need to use the 
media volumes for Monday, Tuesday, and Wednesday nights. 


Notes about the example: 


1. 


2. 


3. 


All of the examples assume that the directory for your Domino server is 
/NOTES/DATA. 


You cannot restore over a database that is in use. All users must close the 
database before you can restore a backup copy. 


Consult your Domino documentation for any special recovery activities that 
you might need to perform after you have restored a Domino database. 
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Example: Restoring Domino databases from an incremental 
backup 
To restore a specific database that is named HRINFO to the HRDPT subdirectory 
(folder), do the following: 
1. Start an iSeries session with a user profile that has *JOBCTL and *SAVSYS 
special authorities. 
2. To ensure that no one is using the databases, stop the Domino server. Use the 
End Domino Server (ENDDOMSVR) command. 
3. Locate the most recent save media that has the database. Do one of the 
following: 
Consult the log that the system creates during the save operation. 
Use the Display Tape (DSPTAP) or the Display Optical (DSPOPT) command 
to display the contents of the save media volume. 
4. Mount the save media volume in the save device. 
5. To restore the database, type the following: 
RST DEV('/QSYS.LIB/media-device-name .DEVD') 
OBJ ('/NOTES/DATA/HRDPT/HRINFO.NSF') 
Notes about the example: 


1. All of the examples assume that the directory for your Domino server is 
/NOTES/DATA. 


2. You cannot restore over a database that is in use. All users must close the 
database before you can restore a backup copy. 


3. Consult your Domino documentation for any special recovery activities that 
you might need to perform after you have restored a Domino database. 


Example: Restoring changed objects from a specific Domino 

subdirectory 

To restore all the Domino databases to the CUSTSVC subdirectory, use the same 

approach that you use to recover the entire server. Do the following: 

1. Start an iSeries session with a user profile that has *JOBCTL and *SAVSYS 
special authorities. 

2. To ensure that no one is using the databases, stop the Domino server. Use the 
End Domino Server (ENDDOMSVR) command. 

3. Locate the save media from your most recent complete backup. Mount the 
correct media volume in the save device. 

4. To restore the entire directory from the media volumes from your last full save, 
use the RST (Restore) command: 

RST DEV('/QSYS.LIB/media-device-name .DEVD') 
OBJ ('/NOTES/DATA/CUSTSVC/*' ) 

5. If your incremental backup media volumes are cumulative, mount your most 
recent incremental backup media volume. Use the same restore command (step 
to restore the changes. 

Otherwise, if your backup media volumes are nightly, repeat step a] for each 
incremental backup media volume. Start with the oldest volume and work 
forward. 


Notes about the example: 


1. All of the examples assume that the directory for your Domino server is 
/NOTES/DATA. 


2. You cannot restore over a database that is in use. All users must close the 
database before you can restore a backup copy. 
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3. Consult your Domino documentation for any special recovery activities that 
you might need to perform after you have restored a Domino database. 


Restoring a Windows server 


Information for restoring a Windows server is in the Information Center. You can 
access the Information Center at the following Web site: 


http://www. ibm.com/eserver/iseries/infocenter 


Restrictions When Using the Restore Command 


The RST command can be used to restore objects to any file system. The topics that 
follow describe restrictions that apply when using the RST command. 


Restrictions When Restoring Objects to Multiple File Systems: When you use the 
RST command to restore objects to more than one file system at the same time and 
the file systems include the QSYS.LIB file system or the QDLS file system, the 
following restrictions apply: 

* Different file systems support different types of objects and different methods of 
naming objects. Therefore, when you restore objects from more than one file 
system with the same command, you cannot specify object names or object 
types. You can restore all objects from all file systems, or you can omit some file 
systems. These combinations are valid: 


— Restoring all objects on the system: OBJ('/*') 


Note: Using this command is not the same as using option 21 from the 
Restore menu. Following are the differences between SAV OBJ(’/*’) and 
option 21: 

- RST OBJ(’/*’) does not put the system in a restricted state. 

- RST OBJ(’/*’) does not start the controlling subsystem when it finishes. 

- RST OBJ(’/*’) does not provide prompting to change default options. 


— Restoring all objects in all file systems except the QSYS.LIB file system and 
the QDLS file system: OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT)) 

— Restoring all objects in all file systems except the QSYS.LIB file system, the 
QDLS file system, and one or more other file systems: 0BJ(('/*') 
('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT) ('/other values' *OMIT)) 


* Values for other parameters of the RST command are supported only for some 
file systems. You must choose values that are supported by all file systems. 
Specify the following parameters and values: 


OPTION 
*ALL 


ALWOBJDIE 
*NONE or *ALL 


LABEL 
*SEARCH 


OUTPUT 
*NONE 


SUBTREE 
*ALL 


SYSTEM 
*LCL 
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DEV (Must be a tape device or an optical device) 


VOL *MOUNTED 

* When you specify RST OBJ(’/*’), the following applies: 
— The system restores only objects that are saved by SAV OBJ(’/*’). 
— The system must be in a restricted state. 
— You must have *SAVSYS or *ALLOBJ special authority. 
— You cannot specify diskette, or save file for the DEV parameter. 
— You must specify SEQNBR(*SEARCH). 


Note: RST OBJ('/*’) is not the recommended method for restoring the entire 
system. |Chapter 4, “Selecting the Right Recovery Strategy”|describes how 


to determine the recovery procedure for your situation. 


Restrictions When Restoring Objects to the OSYS.LIB File System: When you 

use the RST command to restore objects to the QSYS.LIB (library) file system, the 

following restrictions apply: 

* The OBJ parameter must have only one name. 

* You specify objects in the same way that you specify them on the RSTOBJ 
command and the RSTLIB command. |Table 53} shows the valid options for the 


Object (OBJ) parameter when restoring objects to the QSYS.LIB file system and 
the equivalent RSTOBJ or RSTLIB command: 


Table 53. Using the RST Command for QSYS.LIB Objects 


Object Parameter on RST Command Equivalent RSTxxx Command 

OBJ('/QSYS.LIB/Library-name.LIB') RSTLIB SAVLIB(Library-name) 

0BJ('/QSYS.LIB/Library-name .LIB/*') RSTOBJ SAVLIB(Library-name) OBJ(*ALL) 
OBJTYPE (*ALL) 

OBJ ("/QSYS.LIB/Library-name .L1B/*.object-type') RSTOBJ SAVLIB(Library-name) OBJ(*ALL) 


OBJ('/QSYS. 


OBJ('/QSYS. 


OBJ('/QSYS. 


OBJ('/QSYS. 


member-name .MBR' ) 


OBJTYPE (object-type) 


LIB/library-name.LIB/object-name.object-type') pstoBJ SAVLIB(library-name) OBJ(object-name) 


OBUTYPE (object-type) 


LIB/library-name .L1B/file-name .FILE/*') RSTOBJ SAVLIB(library-name) OBJ (file-name) 
OBJTYPE(*FILE) 

LIB/library-name.LIB/file-name.FILE/*.MBR') RSTOBJ SAVLIB(Library-name) OBJ(file-name) 
OBJTYPE(*FILE) 

LIB/library-name.LIB/file-name.FILE/ RSTOBJ SAVLIB(Library-name) OBJ (file-name) 


OBJTYPE(*FILE) FILEMBR((*ALL) (member-name) ) 


* You can specify only object types that are allowed on the RSTOBJ command. For 
example, you cannot use the RST command to restore user profiles because 
OBJTYPECUSRPRF) is not allowed on the RSTOBJ command. 


* Some libraries in the QSYS.LIB file system cannot be restored with the RSTLIB 
command because of the type of information they contain. Following are 
examples: 


-— The QDOC library, because it contains documents. 
-— The QSYS library, because it contains system objects. 


You cannot use the RST command to restore these entire libraries: 


QDOC QSRV QSPLxxxx! 
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QDOCxxxxt QSPL 
QRECOVERY QSYS 
QRPLOBJ QTEMP 


1 Where xxxx is a value from 0002 to 0032, corresponding to an ASP. 


* You can use the new-name element of the object parameter to rename an object 
in a directory, restore an object to a different directory, or restore an object to a 
different library. |Table 54|shows some examples: 


Table 54. New Name Options on the RST Command-Examples 


Object Parameter on RST Command Results 


OBJ(('/DBSDIR/FILEB' *INCLUDE '/DBSDIR/FILEX')) FILEX is created in the DBSDIR directory. The data 


that was saved with FILEB is restored to FILEX. If 
FILEB still exists on the system, it is not changed. 


OBJ(('/DBSDIR/FILE*' «INCLUDE LMSDIR) ) Restores all objects from the DBSDIR whose names 


begin with FILE to the LMSDIR directory. 


OBJ(('/QSYS.LIB/LIB1.LIB' *INCLUDE '/QSYS.LIB/LIB2.LIB')) Library LIB1 (and all objects) are restored as library 


LIB2. 
OBJ(('/QSYS.LIB/LIB1.LIB/*' *INCLUDE All the objects of library LIB1 are restored into 
'/QSYS.LIB/LIB2.LIB')) library LIB2. 
OBJ (('/QSYS.LIB/LIB1.LIB/*.type' All objects of type ‘type’ from library LIB1 are 
*INCLUDE '/QSYS.LIB/LIB2.LIB')) restored into library LIB2. 


* For database file members, OPTION(*NEW) restores members for new files only. 
* Other parameters must have these values: 


SUBTREE 
*ALL 


SYSTEM 
*LCL 


OUTPUT 
*NONE 


ALWOBJDIE 
*ALL or *NONE 


* You can only rename the library, you cannot rename the object. The new name 
must be *“SAME or 


/QSYS.LIB/Libname.LIB 
where the library that is specified by libname must exist. 


Restrictions When Restoring Objects to the QDLS File System: When you use 
the RST command to restore objects to the QDLS (document library services) file 
system, the following restrictions apply: 


* The OBJ parameter must have only one name. 

* The OBJ and SUBTREE parameters must be one of the following: 
— OBJ('/QDLS/path/folder-name') SUBTREE(*ALL) 
— OBJ('/QDLS/path/document-name') SUBTREE(*0BJ) 

* Other parameters must have these values: 


SYSTEM 
*LCL 
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OUTPUT 
*NONE 


ALWOBJDIE 
*ALL or *NONE 


OPTION 
*ALL 


How to Restore Program Temporary Fixes 


If you have restored the Licensed Internal Code or the operating system, you need 
to ensure that the PTFs on your system are current. Do the following: 


1. Print a list of all the program temporary fixes (PTFs) currently on the system. 
Type the following and press the Enter key: 


DSPPTF LICPGM(*ALL) OUTPUT (*PRINT) 


2. Compare this list of PTFs with the list you printed when you saved the system. 
If the lists are the same, return to_your recovery checklist. If PTFs are missing 
from the list you printed in step ee must apply them. Continue with the 
next step. 


3. Find the most recent cumulative program temporary fix media. This package 
could be on distribution media or on a stand-alone media volume. 


Note: If you do not have the PTFs you need, order them and apply them later. 
Continue with your recovery checklist. 


4. You can use option 8 (Install program temporary fix package) on the Program 
Temporary Fix menu. All of the PTFs in the cumulative PTF package will be 
installed for the licensed programs you have installed on your system. Refer to 
the iSeries System PTF Shipping Information Letter for special instructions that are 
required. 


If you want to restore individual PTFs, see the iSeries Information Center at 
http:/ /www.ibm.com/eserver/ iSeries /infocenter. 
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Figure 25|}shows a typical time line for recovering your system. 


Point 1 
> 
Known point (last save) 
Activity occurs 
on system 
Point 2 
> 
Failure occurs 
Hardware repair 
or IPL 
Point 3 
> 
Hardware is available 
Information is 
restored from 
backup 
Point 4 
> 
System is recovered to 
known point 1 
Transactions from 
point 1 to 
point 2 are 
recovered 
Point 5 
> 
System is recovered to 
failure point 2 
Business activity 
from failure 
point 2 to 
recovery point 5 
is recovered 
Point 6 
> 


System is current 
RBANS521-0 


Figure 25. Sample Recovery Time Line 


Chapter 5|through|Chapter 10}describe what is required to reach point 4 in the 


time line. This returns your system to the point of the last complete save operation. 


This chapter describes two procedures that are available to reach point 5 in the 
time line: 


* Restoring changed objects 
* Applying journal changes 


These procedures are designed to recover activity that has occurred since the last 
complete save operation. 
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Task 1—Restoring Changed Objects 


The Backing up your system topic on the Information Center at the following Web 
site: http:/ /www.ibm.com/eserver/iseries/infocenter describes two methods of 
saving changed objects. [Table 55]shows the two methods and the correct restore 
procedures for each: 


Table 55. Restore Procedures for Changed Objects 


Save Method Description Restore Procedure 


Note: The SAVCHGOBJ command does not apply to objects in directories. If you are 
restoring changed objects in directories, go to 
Directories” on page 283]for restore instructions from both the cumulative and not 
cumulative save methods. 


Cumulative You save all changes since the last “Restoring Changed 
complete save operation. Objects by Library” 
Not cumulative You save changes since the last “Restoring Changed 


Objects Individually” 


If you save journal receivers using the SAVCHGOBJ command, read [“Restoring] 
ournal Receivers” on page 258] for special considerations that may apply when 


restoring them. 


SAVCHGOBJ operation. 


Restoring Changed Objects by Library 


Do the following to restore changed objects by library: 

1. Load the SAVCHGOBJ media volume. 

2. Type DSPTAP DEV(media-device-name) OUTPUT(*PRINT) for tape media. Type 
DSPOPT VOL(*MOUNTED) DEV(OPTO1) DATA(*SAVRST) PATH(*ALL) OUTPUT (*PRINT) 
for DVD-RAM optical media. Press the Enter key. 

3. For each library on the list, type: 


RSTOBJ OBJ(*ALL) DEV(media-device-name) SAVLIB(library-name) 
OBJTYPE(*ALL) ENDOPT(*LEAVE) MBROPT(*ALL) 


Repeat this step for each library on the volume. 


Attention! 
If you have changed objects that do not restore because of creation date 
mismatches for files or members, please refer to 


Attributes during a Restore Operation” on page 246 


If you have journaled changes to apply, continue with|“Task 4—Determining 
What Journal Receivers to Use” on page 284] If you do not need to appl 
| “Task 7—Restoring Changed Documents and Folders” 


ournaled changes, skip to 
If you are not sure whether you need to_apply journaled changes, 
continue with 


Restoring Changed Objects Individually 


If your method for saving changed objects is not cumulative, you may have the 
same object on more than one set of SAVCHGOBJ save media. You may choose to 
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restore each set of SAVCHGOBJ save media completely, starting from the oldest 
media volume. This is the simplest method. However, it may be time-consuming if 
you have the same large objects on more than one SAVCHGOBJ media volume. 


If you want to restore each set of SAVCHGOB] save media completely, follow the 
procedure described in}|Restoring Changed Objects by Library” on page 282) for 
each set of save media. If you want to restore each object only once, follow this 
procedure: 

1. Load each SAVCHGOBJ media volume. 

2. Type DSPTAP DEV(media-device-name) OUTPUT(*PRINT) and press the Enter key. 
3. Compare the listings and find the most recent saved copy of each object. 

4. For each object, load the correct media volume and type: 


RSTOBJ OBJ (object-name) DEV (media-device-name) 
SAVLIB(library-name) OBJTYPE(*ALL) 
ENDOPT(*LEAVE) MBROPT(*ALL) 


Repeat this step for each object you need to restore. 
If you have journaled_changes to apply, continue with|“Task 4-Determining 


What Journal Receivers to Use” on page 284] If you do not need to appl 


ournaled changes, skip to|“Task 7—Restoring Changed Documents and Folders” 
If you are not sure whether you need to apply j 


continue with|“Task 3—Determining Whether You Need to Apply Journaled 
Task 2—Restoring Changed Objects in Directories 


Perform this task if you saved changed objects in directories. If you do not need to 
do this task, continue with the next step in your recovery checklist. 


If you use a cumulative method when you saved changed objects from directories 
(your save media contain all objects that have changed since the last complete save 
operation), do the following: 
1. Mount your most recent save media from saving changed objects in directories. 
2. Type: 
RST DEV('/QSYS.LIB/media-device-name.DEVD') 

OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT)) 
If you have journaled changes to apply, continue with 


What Journal Receivers to Use” on page 284 If you do not need to appl 
journaled changes, skip to|“Task 7—Restoring Changed Documents and Folders” 


on page 289} If you are not sure whether you need to apply journaled changes, 
continue with |“Task 3-Determining Whether You Need to Apply Journaled 
Changes” on page 284 


If your save media from saving changed objects in directories is not cumulative, 
repeat the following steps for each set of save media since your last complete save 
operation. Start with the oldest save media volumes and end with the most recent 
volumes. 


1. Mount the media volume. 
2. Type: 


RST DEV('/QSYS.LIB/media-device-name.DEVD') 
OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT)) 


3. If you have journaled changes to apply, continue with|“Task 4—Determining 
What Journal Receivers to Use” on page 284] If you do not need to apply 
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journaled changes, skip to [“Task 7-Restoring Changed Documents and Folders’”| 7—-Restoring [“Task 7-Restoring Changed Documents and Folders’”| Documents and Folders” 
lon page 289 If you are not sure whether you need to apply journaled changes, 
oe with Task 3-Determining Whether You Need to Apply Journaled| 


Task 3—Determining Whether You Need to Apply Journaled Changes 


You may have set up journaling yourself, or you may be using applications that 
use journaling. For example, the OfficeVision program and the iSeries Access 
program use the QUSRSYS/QAOSDIAJRN journal. Some applications provided by 
software vendors also use journaling. 


If you know you have journaled changes to apply, continue with|“Task] 
4—Determining What Journal Receivers to Use”| If you are not sure, do the 


following: 


us 


Type DSPOBJD OBJ(*ALL/*ALL) OBJTYPE(*JRN) OUTPUT(*PRINT) and press the 
Enter key. This command prints a list of all the journals on your system. 


For each journal on the list, do the following: 


a. Type: WRKJRNA JRN(library-name/journal-name). You are shown the Work 
with Journal Attributes display. 

b. Press F19 to display the objects being journaled. 

c. Press F12 to return to the Work with Journal Attributes display. 

d. Press F15 to display the receiver directory. Note the attach and detach times 
for the journal receivers in relation to your journaled objects change dates. 
Additionally, you can use option 8 to display specifics about each journal 

receiver. 

e. Press F12 to return to the Work with Journal Attributes display. 

f. From the information you have seen, you should be able to determine 
whether any objects are being journaled and whether any journal entries 
exist that are more recent than your most recent saved copies of the objects. 
You can also determine which receivers are on the system for the journal. 
Repeat these steps for each additional journal. 


If you need to apply journaled changes, continue with |“Task 4—Determining 


What Journal Receivers to Use”| If you do not need to apply journaled changes, 
skip to}“Task 7-Restoring Changed Documents and Folders” on page 289 


Task 4—Determining What Journal Receivers to Use 


The next several topics describe the general procedure for applying journaled 
changes. 


Follow this procedure: 


1; 


Ensure that all the journal receivers required for the apply journaled changes 
operation are available on the system. In general, you will need all journal 
receivers that were attached to the journal for the length of time for which 
journaled changes are now to be applied to the restored files. 


. Restore all necessary journal receivers that are not already on the system. Use 


the Display Journal Receiver Attributes (DSPJRNRCVA) command to 
determine when a journal receiver was attached to and detached from a 
journal. 


. Determine the name of the last journal receiver (the last receiver restored) and 


whether there are chain breaks by printing the receiver chain: 
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a. Type WRKJRNA JRN(library-name/journal-name) OUTPUT(*PRINT) and press 
the Enter key. You receive a listing that shows the receiver directory and 
all the objects being journaled. 

b. Look at the receiver directory part of the listing. If you saved the currently 
attached journal receiver, your journal receiver directory should look 
similar to The journal receiver that was attached during the save 
procedure shows a status of Partial. The following example shows the 
displayed version of the receiver directory: 


Receiver Directory 


Total size of receivers (in kilobytes). .....: 1507 

Attach Save Size 
Number Receiver Library Date Date Status (K) 
00001 RCVAQO0O1 DSTJRN 06/08/9x  06/08/9x SAVED 42 
00002 RCVAQ002 DSTJRN 06/09/9x 06/09/9x SAVED 900 
00003 RCVA0003 DSTJRN 06/09/9x  06/09/9x PARTIAL 92 
01001 RCVA1003 DSTJRN 06/10/9x 00/00/00 ATTACHED 473 


Figure 26. Receiver Directory—Saving Attached Receivers 


If you save only detached journal receivers, your receiver directory should 
look similar tol Figure 27 


Receiver Directory 


Total size of receivers (in kilobytes). .....: 1507 

Attach Save Size 
Number Receiver Library Date Date Status (K) 
00001 RCVAQ0O1 DSTJRN 06/08/9x  06/08/9x SAVED 42 
00002 RCVAQ002 DSTJRN 06/09/9x  06/09/9x SAVED 900 
00003 RCVAQ003 DSTJRN 06/09/9x  06/09/9x SAVED 92 
01001 RCVA1003 DSTJRN 06/10/9x 00/00/00 ATTACHED 473 


Figure 27. Receiver Directory—Saving Detached Receivers 


4. On the listing, mark the name of the last receiver with a status of SAVED or 
PARTIAL. 


5. Determine the chain of receivers to be used in the APYJRNCHG command 
from the Work with Receiver Directory listing. Mark the first and last receiver 
that you need, based on the date that you saved the objects being recovered. 
Notice that the first and last receiver are the same if only one journal receiver 
was restored. 


Note: While looking at the receiver directory, you should also look for any 
receiver chain breaks. You can determine a chain break by looking at 
the first two digits in the Number column on the Work with Receiver 
Directory display. You cannot apply journaled changes across receiver 
chain breaks. Therefore, you must write down the beginning and 
ending receiver names for each receiver chain. Then you need to run a 
series of apply journaled changes operations, one for each chain using 
these receivers. A chain break may mean that you are missing all or 
part of a journal receiver. (It was on the system and was not saved 
before the failure occurred.) You should evaluate how applying 
journaled changes across a change break may affect the integrity of 
your data. The Journal Management topic in the iSeries Information 
Center (http://www.ibm.com/eserver/iseries /infocenter) has more 
information about receiver chain breaks. 
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10. 


Ti. 


12. 


13. 


. If the ending receiver has a status of PARTIAL (saved-while-attached), 


determine the last entry to be applied for the last receiver: 
a. Type 8 (Display attributes) in the Opt field next to the receiver name. 
b. Write down the value for the Last Sequence Number field. 


. Look at the part of the listing that shows what objects are currently being 
journaled. (You printed the listing in step |3a on page 2851) Compare it to your 


records of what objects should be journaled. Follow the procedures in 
“Printing system information” on page 27|before you save your system. 
For each physical file that should be journaled and does not appear on the 
current listing, type: 
STRJRNPF FILE(library-name/file-name) 

JRN(library-name/journal-name) 
For each access path that should be journaled and does not appear on the 
current listing, type: 
STRJRNAP FILE(Library-name/file-name) 

JRN(library-name/journal-name) 
For each integrated file system object that should be journaled and does not 
appear on the current listing, type: 
STRJRN OBJ (‘object-path-name ') 

JRN(‘journal-path-name') 

For all other object types that should be journaled and do not appear on the 
current listing, type the following: 
STRJRNOBJ OBJ (Library-name/object-name) 

OBUJTYPE(object-type) 

JRN(Llibrary-name/journal-name) 
The journal receiver that is currently attached may not match your naming 
conventions. Usually this is because the journal receiver was created when 
you restored the journal. If this is the case, create a new receiver that follows 
the same naming convention and receiver attributes as the last receiver but 
assign it a number of one greater. In the example shown on the Work with 
Receiver Directory display, you would type: 
CRTJRNRCV JRNRCV(DSTJRN/RCVAQ004) 


Use the CHGJRN command to detach the current receiver and attach the 
journal receiver you just created. In the example, you would type: 


CHGJRN JRN($JRNLA/JRNA) 
JRNRCV (DSTIRN/RCVAQ004) 


Task 5—Applying Journaled Changes for User Journals 


. If you have a single receiver chain for the journal entries that you need to 
apply and the status of the last receiver you are using is SAVED, do one of the 
following: 


a. For objects in libraries type the following: 


APYJRNCHG JRN(1ibrary-name/ journal -name) 
OBJ((library-name/*ALL object-type) ) 
RCVRNG(1ib-name/first-receiver 

lib-name/last-receiver) 
FROMENT(*LASTSAVE) TOENT(*LASTRST) 


b. For objects in directories type the following: 
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APYJRNCHG JRN(jrnlib/jrnname) 
OBJPATH('object-path-name') 
RCVRNG(1ib-name/first-receiver 

lib-name/last-receiver) 
FROMENT (*LASTSAVE) TOENT(*LASTRST) 


Note: If you want to apply journaled changes to library and directory objects 
in the same command invocation, you can use both the OBJ and 
OBJPATH parameters in one APYJRNCHG command invocation. 


If you have a single receiver chain for the journal entries that you need to 
apply and the status of the last receiver you are using is PARTIAL, do one of the 
following: 


a. For objects in libraries type the following: 


APYJRNCHG JRN(library-name/ journal -name) 
OBJ((library-name/*ALL object-type) ) 
RCVRNG(1ib-name/first-receiver 

lib-name/last-receiver) 
FROMENT(*LASTSAVE) TOENT(last-sequence-number) 


b. For objects in directories type the following: 

APYJRNCHG JRN(jrnlib/jrnname) 
OBJPATH('object-path-name') 
RCVRNG(1ib-name/first-receiver 

lib-name/last-receiver) 
FROMENT(*LASTSAVE) TOENT(last-sequence-number) 


where the last-sequence-number is the number you wrote down in step 
of “Task 4—Determining What Journal Receivers to Use” on page 284 


Note: If you want to apply journaled changes to library and directory objects 
in the same command invocation, you can use both the OBJ and 
OBJPATH parameters in one APYJRNCHG command invocation. 

If you have determined that this journal had receiver chain breaks, you must 

decide whether you are actually missing journal receivers and necessary journal 

entries or whether the chain breaks were caused by something else. You should 
evaluate how applying journaled changes across a chain break may affect the 
integrity of your data. The Journal Management topic in the iSeries Information 

Center (http://www.ibm.com/eserver/iseries) provides more information 

about receiver chain breaks. 


If you decide to apply journal entries across chain breaks, you must use a 
APYJRNCHG command for each chain. Type the APYJRNCHG command and 


use these values in place of the values shown in step|1 on page 286 


For the first (earliest) receiver chain: 


RCVRNG 
First and last receivers in this chain 


FROMENT 
*LASTSAVE 


TOENT 
*LAST 
For each middle receiver chain: 


RCVRNG 
First and last receivers in this chain 
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FROMENT 
*FIRST 


TOENT 
*LAST 


For the last receiver chain: 


RCVRNG 
First and last receivers in this chain 


FROMENT 
*FIRST 


TOENT 
last-sequence-number 


where the last-sequence-number is the number you wrote down in step 


Task 6—Applying Journaled Changes for the QAOSDIAJRN Journal 


If you have document library objects, you may need to apply journaled changes 
from the receivers associated with the QAOSDIAJRN journal. If you are not sure, 
determine when you last saved the QUSRSYS library. Then perform the steps 
through step |le|to determine whether you have any journal entries for the 
QAOSDIAJRN journal that are more recent than your save media for the QUSRSYS 
library. 


You cannot apply all journaled changes in the QAOSDIAJRN journal in library 
QUSRSYS. You must specify individual files on the FILE parameter instead of 
*ALL. Do not apply journal changes to the document and folder search index 
database files (QAOSSS10 through QAOSSS15, QAOSSS17, and QAOSSS18) for 
journal QAOSDIAJRN in library QUSRSYS. 


1. Display the receiver chain for the QAOSDIAJRN journal by doing the 
following: 


a. Type: WRKJRNA JRN(QUSRSYS/QAOSDIAJRN) and press the Enter key. 
b. From the Work with Journal Attributes display, press P15 (Work with 


receiver directory). Examine the receiver directory to determine whether any 
chain breaks exist. (See the note on page|5 on page 285}) 

c. Type 8 (Display attributes) in the Opt field next to the receiver name of the 
last receiver that is not attached. 


d. On the Display Journal Receiver Attributes display, write down the value 
for the Last Sequence Number field. 


e. Press F12 three times to return to a command line. 


2. If no chain breaks exist, type the following to apply journaled changes for the 
QAOSDIAJRN journal to individual files: 


APYJRNCHG JRN(QUSRSYS/QAOSDIAJRN) 

FILE((QUSRSYS/QAOKPLCA) (QUSRSYS/QAOSAY05) 
(QUSRSYS/QAOKPX4A) (QUSRSYS/QAOSAY07) 
(QUSRSYS/QAOKP@1A) (QUSRSYS/QAOKPO2A) 
(QUSRSYS/QAOKP03A) (QUSRSYS/QAOKP04A) 
(QUSRSYS/QAOKPO5A) (QUSRSYS/QAOKP06A) 
(QUSRSYS/QAOKPO8A) (QUSRSYS/QAOKPO9A) ) 

RCVRNG(lib-name/first-receiver 

lib-name/last-receiver) 
FROMENT (*LASTSAVE) 
TOENT (Last-sequence-number) 
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where Iast-sequence-entry is the number you wrote down in step|1d on page 288 


If chain breaks exist, you must determine whether any journal receivers are 
missing and how that may affect the integrity of your recovery. If you decide to 
apply journaled changes, use the command shown in step 2] of this topic. 
Repeat the command for each receiver chain, substituting the correct receiver 
range, from-entry, and to-entry parameters. Step |2/in the topic 


5-Applying Journaled Changes for User Journals” on page 286 


use these parameters. 


describes how to 


Task 7—Restoring Changed Documents and Folders 


Perform this task if you_save changed documents and folders. If you do not need 
to_do this task, skip to|Task 2—Restoring Changed Objects in Directories” on 


Do the following: 


1. 


If your procedure for saving changed DLOs is cumulative, load the last daily 
SAVDLO media volume. If your procedure is not cumulative, start with your 
earliest daily save volume and repeat these steps for each set of SAVDLO save 
media. 
If you have documents in user ASPs, display the save media volumes to find 
the sequence numbers for each ASP. Type DSPTAP DEV (media-device-name) 
OUTPUT (*PRINT) for tapes. Mark the names and sequence numbers of the files 
on the listing. They will be named QDOC for the system ASP and QDOCnnnn 
for each user ASP that contains DLOs, where nnnn is the number of the ASP. 
To restore the DLOs to a single ASP, type: 
RSTDLO DLO(*ALL) DEV(media-device-name) SAVFLR(*ANY) 

SAVASP (ASP-number) RSTASP(*SAVASP) 
To restore the DLOs to all ASPs, type: 


RSTDLO DLO(*ALL) DEV(media-device-name) SAVFLR(*ANY) 
SAVASP(*ANY) RSTASP(*SAVASP) 


If an unrecoverable error occurs when running the RSTDLO DLO(ALL 
SAVFLR?*ANY) command, see |“Recovering from an Error While Restoring 
DLOs” on page 59 
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Chapter 12. Mirrored Protection Recovery Actions 


In considering aspects of recovery, you need to distinguish between errors and 
failures in the disk subsystem. 


A disk error refers to an unexpected event during an I/O operation which can 
cause the loss or corruption of the data that is being transferred. Most disk errors 
are caused by a failure in some part of the component chain from the I/O 
processor to the disk surface. Environmental effects such as power abnormalities or 
severe electrostatic discharges can also cause disk errors. Included in the definition 
of disk errors is a failure of the Licensed Internal Code that controls the disk 
subsystem. 


When the system detects an error, generally the occurrence is logged and the 
operation is attempted again. Temporary errors are those from which the system 
can recover and complete the I/O operation successfully. When the error is so 
severe that the I/O operation cannot succeed, it is a permanent error. 


When the system detects a permanent error, it classifies it as a failure in that 
hardware subsystem. In an ASP that does not have mirrored protection, a failure 
causes the system to become unusable. The system displays an error message 
which contains a System Reference Code (SRC) of A6xx 0244, A6xx 0255, or A6xx 
0266 where xx is incremented every minute. During this time, the system will retry 
the operation in which the failure occurred. If the condition that caused the failure 
can be corrected (for example, by powering on a disk unit or replacing an 
electronic component), then normal system operations are resumed. 


On a system with mirrored protection, errors and failures have different effects. 
When a failure occurs on a system with mirrored protection, the recovery 
procedure is affected by the level of protection that is configured. 


System Actions for Permanent Errors 


When a permanent error occurs and mirroring is active, the system attempts to 
recover. The topics that follow describe the actions the system takes for different 
types of permanent errors. 


Device Error: If the system detects a device, I/O processor or bus failure on a 
mirrored unit, it does the following: 


1. The system disables the failing unit and suspends mirroring for the pair. If the 
other unit in the pair is also failing or is already suspended, the first unit is 
considered unprotected. 


2. The system sends a message that identifies the failing unit and indicates that 
mirroring has been suspended. You can use problem analysis on this message 
for more information. 


3. When a disk unit is suspended following an error, the system records all 
updates that are performed on the active unit of the mirrored pair. If the 
suspended disk unit becomes usable within a short period of time, the system 
automatically synchronizes the data between the mirrored units. 


4. After the failed unit is replaced, the system synchronizes the pair and resumes 
mirrored protection. The system sends a message that indicates that mirrored 
protection has been resumed. 
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Read Error: 


1. The system reads from the other storage unit of the mirrored pair. If the 
permanent read error occurs on the other storage unit as well, the original read 
request completes with a permanent read error. 


2. If the read operation from the other storage unit is successful, the data is 
written back to the first unit of the mirrored pair, assigning an alternate sector. 
Only then does the system signal that the original read request is complete. 


Connection Failure: If the system cannot communicate with a device, it does the 

following: 

1. The system attempts to recover from the communications error. Any job 
requesting the disk unit waits during the period that the system is attempting 
recovery. 

2. If the recovery is successful, normal system operations continues. 

3. If the system cannot recover within the time limit for the reset command, the 


unit is considered_to have a device error. The system performs the steps that 
are described in 


Load Source Unit Failure: If an error occurs on the load source unit before the 

Storage Management Recovery portion of the IPL, the system does the following: 

1. The system determines if the other mirrored unit in the load source mirrored 
pair is usable. If not, the system fails. 


2. If the system is able to continue, it starts an IPL from the remaining usable unit 
in the load source mirrored pair. 


Suspending Mirrored Units 


If you have to suspend a mirrored unit, you can do so using the Suspend Mirrored 
Protection option on the Work With Disk Unit Recovery display using SST or DST. 


To suspend mirrored protection, do the following: 
1. Type: 
STRSST 
2. From the System Service Tools (SST) menu, do the following: 
a. Select option 3 (Work with disk units). 
b. Select option 3 (Work with disk unit recovery) on the Work with Disk Units 
display. 
3. Select option 3 (Suspend mirrored protection) on the Work with Disk Unit 
Recovery display and press the Enter key. 


fe > 


Suspend Mirrored Protection 


Type option, press Enter. 
1=Suspend Mirrored Protection 


Serial Resource 
OPT Unit ASP Number Type Model Name Status 
= 1 1 00-31297 6109 030 DDOO2 Resuming 
ue 3 1 00-0184097 6602 050 DDQ11 Active 
3 1 00-0125986 6602 050 DDOO5 Active 
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4. Type a 1 (Suspend Mirrored Protection) in the Option column for each unit that 
you want to suspend mirrored protection. You can suspend protection only on 
units that have both units in an Active or Resuming status. If one of the units is 
in Resuming status, then it is the only unit that can be selected to suspend. It 
takes several minutes to suspend a resuming unit that is using SST. 


If you suspend a mirrored unit that is using SST, the system starts to keep a list of 
disk pages that are changed. If you resume mirrored protection on the suspended 
mirrored unit before this list becomes full, the system uses this list to copy data 
from only those disk pages that were changed instead of copying an entire disk. 


Resuming Mirrored Units 


If you have to resume a mirrored unit, you can do so using the Resume Mirrored 
Protection option on the Work With Disk Unit Recovery display using SST or DST. 


To resume mirrored protection, do the following: 
1. Type: 
STRSST 
2. From the System Service Tools (SST) menu, do the following: 
a. Select option 3 (Work with disk units). 
b. Select option 3 (Work with disk unit recovery) on the Work with Disk Units 
display. 
3. Select option 4 (Resume mirrored protection) on the Work with Disk Unit 
Recovery display and press the Enter key. 


Resume Mirrored Protection 
Type option, press Enter. 
1=Resume Mirrored Protection 
Serial 
Resource OPT Unit ASP Number Type Model Name Status 
Z 3 00-59681F7 6602 050  DD004 Suspended 


4. Type a 1 (Resume Protection) in the Option column for each unit that you want 
to resume mirrored protection. You can select only a unit in Suspended status to 
resume. 


Replacing a Mirrored Unit 


A unit selected to replace the failed mirrored unit must satisfy all of the mirrored 


protection configuration rules and restrictions when it is paired with the remaining 
unit in the mirrored pair. (See|“Mirrored Protection—Configuration Rules” on 
ipage 443) ) 


You can replace mirrored units by using the Replace Disk Unit option in either 
DST or SST. To do this, you need to have a spare storage unit that can be paired 
with the mirrored unit of the storage unit that is being replaced. The storage unit 
being replaced can have a status of active or suspended. However, one of the 
storage units in the pair must be suspended. The results of the replace operation is 
different for each status. Replacing a suspended storage unit causes that storage 
unit to go to a status of resuming after the replace operation. Replacing an active 
unit causes data in the ASP to be lost, so you must first delete the data in ASP 
(using the DST ’Delete ASP Data’ option). The storage unit being replaced can also 
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be missing or not missing. To replace a unit with a status of resuming, you must 
suspend it. If the status of unit 1 is unknown, replace operations are not allowed 
until the status of the mirrored units for unit 1 is known. The unit selected to 
replace another mirrored unit must satisfy all of the mirrored protection 


configuration rules and restrictions when it is paired with the remaining unit in the 
mirrored pair. (See |“Mirrored Protection—Configuration Rules” on page 443}) 
If a storage unit fails, and if the same storage unit that failed has been repaired, it 


is not necessary to replace it. The failed disk should have a status of suspended 
and can be resumed after the repair is complete. 


If the storage unit that is being replaced is active, it can only be replaced at DST 
before the IPL to the OS/400 licensed program. It should never be necessary to 
replace an active unit unless both units of the mirrored pair have failed. If this 
situation does occur, the service representative should first try to recover the data 
from the failed units using the Save Disk Unit Data option on the Work with Disk 
Unit Recovery display. When an active unit is replaced, the last good copy of the 
data has been lost. The data in the ASP that contains the unit being replaced must 
be deleted using the DST ‘Delete ASP Data’ option before an active unit is allowed 
to be replaced. 


Replacing unit 1 requires special handling. If the system ASP has mirrored 
protection, one of the units in the mirrored pair for unit 1 is selected as the IPL 
device. It is the only unit that is used until the system performs an IPL to the 
OS/400 licensed program. Until then, it cannot be replaced or even suspended. 
However, its mirrored unit can be both suspended and replaced. After the IPL to 
the OS/400 licensed program, the IPL device can be suspended and then replaced. 


Replacing a unit may cause the level of protection for a mirrored pair to change. If 
a lower level of protection results from a replacement operation, it displays a 
warning screen. At certain times, especially when missing units are involved in the 
replace operation, the system may not be able to accurately calculate the level of 
protection and the same warning display is shown. 


To replace a disk unit by using SST, do the following: 
1. Type: 
STRSST 
2. From the System Service Tools (SST) menu, do the following: 
a. Select option 3 (Work with disk units). 
b. Select option 3 (Work with disk unit recovery) on the Work with Disk Unit 
display. 
3. Select option 1 (Replace configured unit) on the Work with Disk Unit Recovery 
display and press the Enter key. 
The Select Configured Unit to Replace display is shown. 


( Select Configured Unit to Replace ) 
Type option, press Enter. 
1=Select 
Serial 
Resource OPT Unit ASP Number Type Model Name Status 
" 1 1 @0-0163477 6602 030 DDO19 Suspended 
L 1 2 1 @0-17900 6602 030 DDO02 Suspended ) 
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4. Type a 1 in the Option column on the Select Configured Unit to Replace display 
and press the Enter key. 


( Select Replacement Unit > 
Serial 
Resource Unit ASP Number Type Model Name Status 
2 1 00-17900 6602 030 DDO02 Suspended 


Type option, press Enter. 1=Select 


Serial 
Resource Option Number Type Model Name Status 
= 00-0330477 6602 030 DDO05 Non-configured 
2 1 00-0323200 6602 030 0DD033 Non-configured ) 


5. Type a 1 in the Option column on the Select Replacement Unit display and 
press the Enter key. 


(~ Confirm Replace of Configured Unit >) 


This screen allows the confirmation of the configured unit to be replaced 
with the selected replacement unit. Press Enter to confirm your choices for 
Replace Press F12 to return to change your choices. The configured unit 
being replaced is: 

Serial 
Resource Unit ASP Number Type Model Name Status 
2 1 00-17900 6602 030 DDO02 Suspended 


The replacement unit will be: 


Serial 
Resource Unit ASP Number Type Model Name Status 
L 2 1 00-0323200 6602 030  DDO33 Resuming ) 


6. Press Enter to Confirm. 


7. The replacement function runs for several minutes. Wait until the replacement 
function completes. 


Using Spare Nonconfigured Units for Replacement 


If mirrored units become suspended as a result of a hardware failure, the system 
continues to run. However, one or more storage units will be suspended and 
therefore unprotected until your service representative can repair or replace the 
failed hardware. If you have spare nonconfigured units, you may be able to 
resume mirrored protection before the repair actions are done. 


Call your service representative. You may be directed to examine the Service 
Action Log for information that is concerning the failure. Use the Display Disk 
Configuration Status option by using SST or the Work with Disk Status 
(WRKDSKSTS) command to determine which units are suspended. If all disk units 
under an I/O processor are suspended, the I/O processor probably has failed. If 
you have enough spare units of the right type and model, and if the spare units 
are not on the I/O processor that has failed, you may be able to use the spare 
nonconfigured units to resume mirrored protection. 
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After your service representative repairs a failed storage unit, you may want to use 
it instead of the spare to restore the previous level of protection. To use the 
repaired unit, do the following: 


1. Suspend the active storage unit that was previously used as the spare by 
typing the following on a command line and pressing the Enter key. 
STRSST 
2. From the System Service Tools (SST) menu, do the following: 
a. Select option 3 (Work with disk units). 
b. Select option 3 (Work with dik unit recovery) on the Work with Disk Units 
display. 
3. Select the option 3 (Suspend mirrored protection). 


Suspend Mirrored Protection 


Type option, press Enter. 
1=Suspend Mirrored Protection 


Serial 
Resource OPT Unit ASP Number Type Model Name Status 
= Ll 00-0193825 6602 030 DDOO1 Active 
es i el 00-0184097 6602 030 DDO19 Active 
_ aaa 00-0125986 6602 030 DDO36 Active 
 - 2 al 00-0125986 6602 030 DDOOZ Active y) 


4. Type a1 (Suspend Mirrored Protection) in the Option column. The original 
spare unit is the same disk type and model as the repaired disk unit. 


5. Return to the Work with Disk Unit Recovery display by pressing F12 (Cancel) 


‘a Work with Disk Unit Recovery > 


Select one of the following: 

Replace configured unit 

Disk unit problem recovery procedures 
Suspend mirrored protection 

Resume mirrored protection 

Delete disk unit data 

Rebuild disk unit data 


AaPwNnr 


6. Select option 1 (Replace configured unit). 


Select Configured Unit to Replace 
Type option, press Enter. 


1=Select 
Serial 
Resource OPT Unit ASP Number Type Model Name Status 
_ th 1 00-0163477 6602 030 DDO19 Suspended 
1 2 1 00-17900 6602 030 DDO02 Suspended 


7. Type a 1 in the Option column on the Select Configured Unit to Replace 
display and press the Enter key. 
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la » 


Select Replacement Unit 


Serial 
Resource Unit ASP Number Type Model Name Status 
2 1 00-17900 6602 030 DDO02 Suspended 
Type option, press Enter. 1=Select 
Serial 
Resource Option Number Type Model Name Status 
= 00-0330477 6602 030 DDO05 Non-configured 
L 1 00-0323200 6602 030 DD033 Non-configured ) 


8. Type a 1 in the Option column on the Select Replacement Unit display and 
press the Enter key. 


( Unit ) 


This screen allows the confirmation of the configured unit to be replaced 
with the selected replacement unit. Press Enter to confirm your choices for 
Replace Press F12 to return to change your choices. The configured unit 
being replaced is: 

Serial 
Resource Unit ASP Number Type Model Name Status 
2 1 00-17900 6602 030 DDO02 Suspended 


The replacement unit will be: 


Serial 
Resource Unit ASP Number Type Model Name Status 
L 2 1 00-0323200 6602 030 DD033 Resuming 4 


9. Press Enter to confirm. 


10. The replacement function runs for several minutes. Wait until the replacement 
function completes. 


Mirrored Protection Recovery Actions Performed by the 
Service Representative 


The procedures that are described here are overviews of the steps and 
considerations involved in disk unit repair in the mirrored environment. Although 
your service representative performs these steps, they are included here for your 
information. 


Actions When Concurrent Maintenance is Possible 
1. Perform problem analysis on the failing storage unit. 


Performing problem analysis may cause mirrored protection to be suspended 
on the failing storage unit, and in some cases, on additional storage units. 


2. Power down the failing storage unit. 
3. Repair or replace the failing storage unit. 


4. If the Replace Configured Unit option is necessary, the new storage unit is 
formatted and initialized, and mirrored protection is automatically resumed. 

5. Resume mirrored protection on the repaired unit, if necessary, and on any other 
units that were suspended as part of the repair action. 
Synchronization begins on the resuming storage units immediately, and a 
message is sent to the QSYSOPR message queue when synchronization 
completes. 
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Actions When Concurrent Maintenance is Not Possible 
1. Power down the system. 


2. If unit 1 has failed, see|“Mirrored Protection—Configuration Rules” on page 443 


for restrictions that apply. 
3. Perform an attended IPL to DST. 
4. Perform problem analysis on the failing storage unit. 


Performing problem analysis may cause mirrored protection to be suspended 
on the failing storage unit, and in some cases, on additional storage units. 


5. Power down the failing storage unit. 
6. Repair or replace the failing storage unit. 


7. If the Replace Configured Unit option is necessary, the new storage unit is 
formatted and initialized, and mirrored protection automatically resumes. 


8. Resume mirrored protection on the repaired unit, if necessary, and on any other 


storage units that were suspended as part of the repair action. 


9. Continue the IPL to command entry. Synchronize the resuming storage units 
during the IPL. 


Other Recovery Considerations for Mirrored Protection 


Message Handling: When a system with mirrored protection experiences a disk 
failure, the only external indication of the failure is a message that is sent to the 
system operator message queue (QSYSOPR). If there is a message queue that is 
named QSYSMSG in the QSYS library, the messages are sent there also. 


When suspended units exist, the system sends a message every hour to the 
QSYSOPR message queue as a reminder. 


You should have a method of bringing these messages to the attention of the 
system administrator. If the interactive job at the console allocates the QSYSMSG 
message queue and places it in break mode, it notifies you of any problems. For 
more information on QSYSMSG, see the CL Programmer's Guide. 


Synchronization: When the system is synchronizing (resuming) a disk unit, the 
system response time becomes longer. 


When mirrored protection is resumed on a suspended disk unit at DST, the 
synchronization to the OS/400 licensed program is done during the IPL. 


Mirrored Protection Disk-Error Handling 


Mirrored protection handles disk errors as follows: 


Unrecoverable device error: 


1. The system suspends the failing storage unit and mirrored protection is 
suspended for the mirrored pair. 


2. The system continues operations by using the operating storage unit of the 
mirrored pair. 


3. A message sent to the QSYSOPR message queue identifies the failing storage 


unit. It informs you that mirrored protection is suspended for the mirrored pair. 


Permanent read error: 


298 0S/400 Backup and Recovery V5R2 


1. The system reads from the other storage unit of the mirrored pair. If the 
permanent read error occurs on the other storage unit as well, the original read 
request completes with a permanent read error. 


2. If the read operation from the other storage unit is successful, the data is 
written back to the first unit of the mirrored pair, assigning an alternate sector. 
Only then does the system signal that the original read request is complete. 


Not operational storage unit: 


1. The system attempts recovery. If it is successful, normal system operations 
continue with mirrored protection and without suspending or synchronizing 
the unit. 


2. If recovery is unsuccessful, the unit is considered to have an unrecoverable 
device error, which is processed as described previously. 


Time-out: 

1. The system attempts to recover from the timeout. If it is successful, normal 
system operations continue with mirrored protection and without suspending 
or synchronizing this unit. 

2. If recovery is unsuccessful, the storage unit is considered to have an 
unrecoverable device error, which is processed as described previously. 


I/O processor or bus failure: 


1. The system suspends each disk unit that is attached to the failing I/O processor 
or bus in the same way it is done for an unrecoverable error. 


2. The system saves a copy of the failing I/O processor’s storage so the problem 
can be diagnosed. The system continues without the failing I/O processor. 


Disk-related failure of unit 1 before the IPL to the Operating System/400: See 


“Mirrored Protection—Configuration Rules” on page 443] for restrictions that apply. 
Missing Disk Units 


If a disk unit, a controller, or an I/O processor fails during an IPL, the system 
detects the failure and does one of the following: 


* Displays an SRC on the control panel if the keylock switch is not in the Manual 
position. 

* Displays the Missing Disk Unit display on the console if the keylock switch is in 
the Manual position. 


If the failing unit has mirrored protection and its mirrored unit is active, the 
following display is shown. 


( Disk Configuration Warning Report ie 


Type option, press Enter. 
5=Display Detailed Report 


Press F10 to accept all the warnings and continue the IPL. 
The system will attempt to correct the warnings. 


OPT Warning 
5 Missing mirror protected units in the configuration 


“ y 


Type a 5 in the option column and press the Enter key. 
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Suspend Missing Disk Units 


The following disk units are missing from the disk configuration: 


Serial 
Resource Reference ASP Unit Type Model Number Name Code 
1 2 6602 030 00-0190494 DD036 1713 


You can suspend mirrored protection on the affected units and continue the IPL. 
An entry is written in the problem log. You can run problem analysis on the failing 
unit at a later time. The type and reference code fields can be used with the unit 
reference code guide to determine the cause of the problem. If the keylock switch 
is not in the Manual position, a system reference code is displayed on the control 
panel. If the affected units do not report to the system within six minutes, the 
system automatically suspends mirrored protection on the affected units and 
continues the IPL. 


If the suspended disk units become ready before the system is powered down, the 
system will automatically resume mirrored protection on these units. 


Saving a Unit 


The system allows you to save data from storage units that use the DST Save Disk 
Unit Data option. 


The following rules apply to saving units on a system with mirrored protection: 
* Only configured units can be saved. 


* The save operation is not allowed when both mirrored units of a mirrored pair 
are active. Only one of the mirrored units can be saved. Therefore, one mirrored 
unit must be suspended. 


* Only the active unit of a mirrored pair can be saved because the active unit 
contains the current data. 


* If multiple failures cause the state of unit 1 to be unknown, saving of any 
storage unit is not allowed. 


Restoring a Unit 


In the mirrored environment, the system allows you to restore data to storage 
units. 


The following rules apply to restoring units on a system with mirrored protection: 
* The restore is possible only for an active device. 
* This option can restore to either a configured or nonconfigured disk unit. 


* The restore operation requires that the unit restored to is as large as or larger 
than the unit saved. 


* The restore operation is not permitted if the state of a unit is unknown. You can 
restore unit 1 only to the IPL device. 


* After a unit is restored, the system performs an IPL to DST. 


* The unit being restored must satisfy all mirrored protection configuration rules 
and restrictions. 
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Active Mirrored Load Source Failure 


If unit 1 is mirrored, the system attempts to IPL from a load source mirrored unit 
that contains Licensed Internal Code and system data. The mirrored unit state of 
that storage unit will be active. 


System Cannot Find Active Mirrored Load Source for IPL 

If the system cannot find a load source unit that contains current data and can 
only find a load source unit that is suspended or resuming, the system will IPL on 
the suspended/resuming unit. That unit contains back-level data. The system 
cannot be used until it finds or repairs the active mirrored load source. 


If the system has not been able to IPL on an active mirrored load source, it is 
presumed to be broken in some way, and the following screens are displayed. 


e Disk Configuration Error Report >) 


Type option, press Enter. 
5=Display Detailed Report 


OPT Error 
5 Load source failure 


Type a 5 in the option column and press the Enter key. 


( Display Load Source Failure ) 


The system could not use the load source disk unit that 
contains correct data. 


The following disk unit contains the correct data: 


Disk unit: 

DVD G vet eats eo ee ee ee ee es ee et © 6003 
Model 2 34.2% 24 Bee ae Gee a SS 030 
SEniall MUMDEIs ee oreetener see curses cee eece oes 00-0193825 
RESOURCEMNAMG: cept es et ey se oeet nee eects DDOO1 


Press Enter to use Dedicated Service Tools (DST). 


Active Mirrored Load Source Being Used for IPL Fails 

If the system is IPLing on an active mirrored load source and that storage unit fails 
during the IPL to DST or at DST, the system attempts to perform a directed IPL to 
the other storage unit (tries to re-IPL on the remaining load source). 


* If the directed IPL fails, the system ends abnormally and displays a system 
reference code. 

* If the remaining storage unit of the load source mirrored pair is active and the 
original load source is still broken on the re-IPL, the broken load source is 
treated like any other missing mirrored unit, and the following are displayed: 
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Disk Configuration Warning Report 
Type option, press Enter. 
5=Display Detailed Report 


Press F10 to accept all the warnings and continue the IPL. 
The system will attempt to correct the warnings. 


OPT Warning 
5 Missing mirror protected units in the configuration 


Type a 5 in the option column and press the Enter key. 


Suspend Missing Disk Units 
The following disk units are missing from the disk configuration: 


Serial 
Resource Reference ASP Unit Type Model Number Name Code 
1 2 6602 030 00-0190494 DD036 1713 


* If the remaining storage unit of the load source mirrored pair does not contain 
current data (it is suspended or resuming), it is treated as if the system cannot 
find an active mirrored load source for IPL, as described earlier. The IPL is not 
allowed to continue past DST until the active load source is found or repaired. 


Active Mirrored Load Source Fails Late in the IPL or at Runtime 
When an active mirrored load source fails after Storage Management Recovery is 


completed, it is treated like a failure in any other mirrored pair: 

* If the other storage unit in the mirrored pair is present and active, the failing 
unit is suspended and the system continues to run using data the data on the 
remaining active unit of the pair. 


* If the failing storage unit is the last active unit of the mirrored pair (the other 
unit of the pair is either suspended or resuming), the system displays a DASD 
Attention system reference code and becomes unusable. 


Cannot Read System Configuration Data from Active Mirrored 
Load Source 

If the system cannot read the system configuration data from the active mirrored 
load source that is being used for the IPL, one of the following screens is 
displayed. 


e Accept Load Source Warning Report 


Some of the configuration information on the load source is 
missing. The system can rebuild this information using 
the default values. 


Press Enter to let the system rebuild the configuration 
information on the load source. 


If you were performing any disk unit recovery actions, go to 
Work with Disk Units and complete those actions. 
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Disk Configuration Warning Report 
Type option, press Enter. 
5=Display Detailed Report 


Press F10 to accept all the warnings and continue the IPL. 
The system will attempt to correct the warnings. 


OPT Warning 
5 Bad load source configuration 


Unknown Unit 1 Status 


If both the service processor and one unit of the mirrored pair for unit 1 have 
failed, the following display is shown. 


(~ Disk Configuration Error Report ) 


Type option, press Enter. 
5=Display Detailed Report 


OPT Error 
5 Unknown load source status ) 
Type a 5 in the option column and press the Enter key. 
Display Unknown Mirrored Load Source Status 
The system can not determine which disk unit of the load 
source mirrored pair contains the correct level of data. 
The following disk unit is not available: 
Disk unit: 
I DONG. eon cece ts ep sane! ee ey Ge ep Gees sae ae 0003 
Model a vitg) seen css ee a eee ene ee se O80 
Serial number? 4:5) 6 3 aw a See a :  00-0193825 
Resource name ............. =:  °£42DDOOL 
Press Enter to continue. 
Ne SJ 


If the keylock switch is not in the Manual position, the control panel displays a 
system reference code . 


The missing unit must be repaired or the state of the unknown load source 
recovered. If the missing unit can be repaired without losing the data on the unit, 
then the state of the load source will become known when the system is IPLed. If 
the missing unit cannot be repaired or if the data on it is lost, then you can 
possibly recover the state of the unknown load source and avoid restoring the 
entire system. 


You should only attempt to recover the state of the unknown load source when 


you know its mirrored unit state was active before the failures that caused the state 
to become unknown. Since the state is unknown, the system cannot verify that 
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your choice is correct. If you recover the state of the unknown load source when 
the actual state of the disk unit used to IPL was not active, you will cause data loss 
or damaged objects on your system. 


To Recover the State of the Unknown Load Source 
1. From the DST main menu, select option 4, Work with disk units. 


2. From the Work with disk units menu, select option 2, Work with disk unit 
recovery. 


3. From the Work with disk unit recovery menu, selection option 15, Recover 
unknown load source. 


This will display a confirmation screen, showing the disk configuration and 
mirrored unit states the system will have after the recovery. 


4. If the configuration and states are as you expect, press Enter to confirm. 


The state of the load source mirrored pair is changed so that the load source 
just used to IPL is active and the other (missing) load source is suspended. 


If you cannot recover the state of the unknown load source and if the missing unit 
cannot be repaired, you must install the Licensed Internal Code and restore the 
entire system. 


Display Incorrect Licensed Internal Code Install 


When the Licensed Internal Code is restored on a mirrored unit for unit 1, one of 
the mirrored units may have the incorrect level of data stored on it. If this 
condition occurs, and the disk unit that contains the correct data is not available, 
the Licensed Internal Code is restored to the disk unit with the incorrect data. 
When a disk preforms an IPL and the correct disk unit is available, the following 
display is shown. If the keylock switch is not in the Manual position, system 
reference code (SRC) is shown on the control panel. 


a Display Incorrect Licensed Internal Code Install a 


Licensed Internal Code has been installed on the incorrect 
disk unit of the load source mirrored pair. 


If you continue the IPL, the previously installed Licensed Internal 
Code installed on the incorrect disk unit of the mirrored 

load source pair will be deleted. The Licensed Internal Code 

will be replaced by the Licensed Internal Code from the correct 
disk unit. 


The following disk unit is the correct disk unit. 


Disk unit: 
TYPOS Pe occpetes fs nse chk eee eee ss “on ene 6602 
MOd eh Munaes were yatta cece can Sy ares mr ease 030 
Serial number) 02 2 lee 25 ee aes, E 00-0163477_ 
Resounce-names 4. 2-%: i sac, ote oe DDOQ19 


Press Enter to continue. 
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Chapter 13. How to Restore Your System Using Operational 
Assistant Tapes 


mneaceis 
provides a list of the steps necessary to recover 
user information on your system. This chapter describes specific tasks associated 
with restoring information from Operational Assistant backup tapes. The 
descriptions assume that you are recovering all the data on your system. If you are 
recovering a single library or a single ASP, adapt the procedures to your situation. 


Figure 28 on page 306|shows the parts of your system and how they are saved with 


Operational Assistant. Refer to it in the topics that follow. 
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Options from 
RUNBCKUP menu 


Licensed Internal Code Saved using 


OS/400 Objects in QSYS SP EaWEeE aca 


option 1, 2, or 3 
< 


User Profiles 
Private Authorities 


Can be 
included 
on 

11 Configuration Objects *DAILY, 
*WEEKLY, 
or 


> — *MONTHLY 
OS/400 Optional Libraries backup 


* QHLPSYS options 
¢ QUSRTOOL 

Licensed Program Libraries 
* QRPG 

° QCBL 

© QXXXXXx 


IBM Libraries with User Data 
* QGPL 

¢ QUSRSYS 

°¢ QS36F 

e # LIBRARY 

User Libraries 

* LIBA 

¢ LIBB 

e LIBC 

e LIBxxx 


Documents and Folders 
Distribution Objects 


User Objects in Directories 
*DIRA 

* DIRB 

¢DIRC 

¢ DIRxxx 


IBM Directories 


> 


RBANS522-0 


Figure 28. How the System Is Saved with Operational Assistant Backup 


How to Restore Your Libraries 


To recover your entire system, you must restore IBM-supplied libraries and user 
libraries. To restore IBM-supplied libraries, do the following: 


1. Find the tapes that you used most recently to save IBM-supplied libraries. You 
saved them by using one of these methods: 


* Option 10 from the Run Backup menu. 
* Option 11 from the Run Backup menu. 
¢ The SAVLIB LIB(*IBM) command. 

* The SAVLIB LIB(*NONSYS) command. 
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* Option 21 from the Save menu. 
* Option 22 from the Save menu. 
* Option 41 from the Save menu. 


2. Mount the first tape and type: RSTLIB SAVLIB(*IBM) DEV(media-device-name). 
Press the Enter key. 


To restore user libraries, do the following: 


1. Find the tapes that you used most recently to save all user libraries. You saved 
them by using one of these methods: 


* Option 1, 2, or 3 from the Run Backup menu and specifying 2 (All) for the 
User libraries option. 


* Option 11 from the Run Backup menu. 
¢ The SAVLIB LIB(*ALLUSR) command. 

* The SAVLIB LIB(*NONSYS) command. 

* Option 21 from the Save menu. 

* Option 23 from the Save menu. 

* Option 40 from the Save menu. 

* Option 42 from the Save menu. 


If you are not sure which tapes have your user libraries on them, do the 

following for each possible tape: 

a. Mount the tape. 

b. Type DSPTAP DEV(media-device-name) 

c. Page through the displays, looking for the file called QFILE. 

d. When you find the tape with the QFILE file on it, write down the sequence 
number for that file on the tape. 

e. Leave the tape in the tape unit and type: DSPTAP DEV (media-device-name) 

LABEL(QFILE) SEQNBR(sequence-number) DATA(*SAVRST) OUTPUT (*PRINT). 

f. If the listing contains user libraries, it was created by either the 
SAVLIB(*NONSYS) command or the SAVLIB(#*ALLUSR) command. The 
libraries from the tape can be restored using the RSTLIB SAVLIB(*ALLUSR) 
command. 

2. Mount the first tape that has user libraries and type: RSTLIB SAVLIB(*ALLUSR) 

DEV (media-device-name). Press the Enter key. 


You have now restored all the libraries on your system to the point where the 


were all saved completely. Return to|“Recovering User Information Using Tapes 
from Operational Assistant Backup—Checklist 27” on page 117 


How to Restore Libraries That You Saved by Using a Backup List 


This topic describes how to restore libraries that you saved using a backup list, 
either for daily or weekly backup. It assumes that you save all libraries for your 
monthly backup. This topic describes how to restore libraries, not changed objects. 
Use this procedure if all of the following are true: 


* You have an Operational Assistant backup that is more recent than the last time 
you saved the entire system or all libraries. 


* You specified 1 (Selected from list) for the User libraries option for your 
Operational Assistant backup. 


Chapter 13. How to Restore Your System Using Operational Assistant Tapes 307 


* You specified N (No) for the Save changed objects only option for your Operational 
Assistant backup. 


If you have both a weekly and a daily backup that meet these conditions, do the 

following: 

* If your daily backup and weekly backup both save exactly the same libraries 
from the backup list, perform steps 2] through 4Jonce, using your most recent set 
of tapes (daily or weekly). 

* If your daily backup saves fewer libraries than your weekly backup, do the 
following: 

— If your most recent backup is a weekly backup, perform steps 2] through [4] 
once, using your most recent set of weekly tapes. 

— If your most recent backup is a daily backup, perform steps|2] through [Jonce, 
using your most recent set of weekly tapes. Repeat step} through |4} using 
your most recent set of daily tapes. 

1. Mount the first tape. 


2. Find the printed copy of the backup list associated with the save tapes. If you 
have the list, skip to step 

3. If you do not have the list, display the contents of the save tapes by typing: 
DSPTAP DEV(media-device-name) OUTPUT(*PRINT) DATA(*SAVRST). 

4. Use the listing from step Por step|3| For each library that was saved, do the 
following: 
a. Type: RSTLIB SAVLIB(library-name) DEV(media-device-name). 
b. Check off the library name on the list. 


Note: Restore the user libraries to each user ASP that you are recovering. If 
you are restoring the QGPL library and the QUSRSYS library and doing 
partial recovery, restore these libraries before any other libraries. When 
recovering the entire system, there is no need to restore QGPL and 
QUSRSYS libraries first. 


How to Restore Changed Objects That You Saved by Using 
Operational Assistant 


If you save only changed objects for either your weekly or daily backup, use this 
procedure. If you save changed objects both weekly and daily, use your most 
recent set of tapes. If you save complete libraries on your weekly backup and 
changes on your daily backup, perform this procedure only if your daily backup is 
more recent than your weekly backup. 


Do the following: 
1. Mount the first tape from your most recent backup of changed objects. 


2. Determine if any objects are on the tape for libraries that do not exist on the 
system: 


a. Print a list of libraries on the system by typing: DSPBCKUPL OUTPUT (*PRINT). 


b. Print the contents of the tape by typing: DSPTAP DEV(media-device-name) 
OUTPUT (*PRINT) DATA(*SAVRST). 


c. Compare the two lists. Mark any libraries on the DSPTAP listing (from step 
that do not appear on the DSPBCKUPL listing (from step pal. 
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d. For any libraries you marked in step |2c on page 308} type the following: 


CRTLIB LIB(library-name). 


3. Restore the changed objects from the tapes. For each library that appears on the 
DSPTAP listing (from step |2b on page 308), type: 


RSTOBJ OBJ(*ALL) SAVLIB(library-name) 
OBUTYPE(*ALL) DEV(media-device-name) 
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Chapter 14. How to Restore the System from the Save 
Storage Media 


When you recover your system from the Save Storage (GAVSTG) media in a 
disaster recovery situation, you reset your system to the point when the SAVSTG 
procedure was run. Your system will not be available for use until the restore 
process completes successfully. 


The disk configuration of the restoring system must be the same as the disk 
configuration of the saving system. There must be at least as many disk units on 
the restoring system as there were on the saving system. Each disk unit capacity 
on the restoring system must be equal to or greater than the capacity of the disk 
unit on the saving system. Serial numbers and physical addresses do not have to 
be the same. All disk units that were saved are required for the restore operation. 


The restore storage process does not automatically start or stop device parity 
protection on the restoring system. If you determine that the disk units on the 
restoring system should be protected with device parity protection, start device 
parity protection before restoring the SAVSTG tapes. 


If your system has mirrored protection now, when the restore storage procedure 
runs, your system will not have mirrored protection on any Auxiliary Storage Pool 
(ASP). 


Find These Things Before You Begin: 


* The list of all the Licensed Internal Code fixes applied to your system at the 
time you saved storage. This list should be attached to your backup log or 
found with the SAVSTG tapes. 


* If you applied any PTFs since the last save storage operation, you will need 
your most recent cumulative PTF tape. 


* A recent SAVSYS or SAVCFG media volume. The SAVSYS or SAVCFG media 
contains configuration information that you will have to restore after the restore 
storage is completed. 


Do These Things Before You Begin: 
* Clean the read and write head of the tape unit. 


* Print a list of all the Licensed Internal Code fixes currently on the system. Type 
the following and press the Enter key: 


DSPPTF LICPGM(*ALL) OUTPUT (*PRINT) 


Considerations for recovering to a different system: 


* Ensure that your restoring tape drive supports the capabilities of your storage 
tapes in regard to compression and compaction. 


* Performance on the target system may be different than the source system if you 
use different disk protection mechanism. 


* In the future you must obtain software license keys for the target system. 
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Task 1—Powering Down the System and Loading the Licensed Internal 
Code 


1. Ensure that all users are off the system. 


2. Type the following to power down the system: 
PWRDWNSYS OPTION (*IMMED) 
;— Attention logical partitioning users! 
If you are going to use this command on the primary partition, be sure to 
power off all secondary partitions before running the command. 
3. 


Load the first SAVSTG tape in the tape unit that is your alternative IPL device. 


4. Install the Licensed Internal Code by using the procedure that is described in 


“Task 2-Powering Down the System” on page 125] through |“How to Load the 
Licensed Internal Code” on page 132} Select option 2 (Install Licensed Internal 
Code and Initialize System) from the Install Licensed Internal Code (LIC) 


display. When the procedure asks for SAVSYS media, use your SAVSTG tapes 
instead. 


Task 2—Restoring the Save Storage Tapes 


1. When the IPL following the installation of the Licensed Internal Code 


completes, the Disk Configuration Attention Report display is shown. Press 


F10 to accept the new configuration. The IPL or Install the System menu is 
displayed. 


IPL or Install the System 
Select one of the following: 


. Perform an IPL 
. Install the operating system 
. Use Dedicated Service Tools (DST) 


. Perform automatic installation of the operating system 
. Save Licensed Internal Code 


OrWNr 


2. Select option 3 (Use Dedicated Service Tools (DST)) and press the Enter key. 
The Dedicated Service Tools (DST) Sign On display is shown. 


Dedicated Service Tools (DST) Sign On 
Type choice, press Enter 


DST user 


3. Sign on DST with the DST security-level or full-level password. The iSeries 
Security Reference book has more information about DST passwords. 


The Use Dedicated Service Tools (DST) menu is shown. 
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a _ 


Use Dedicated Service Tools 
Select one of the following: 


Perform an IPL 

Install the operating system 

Work with licensed internal code 

Work with disk units 

Work with DST environment 

Select DST console mode 

Start a service tool 

Perform automatic installation of the operating system 
Work with save storage and restore storage 

Work with remote DST support 


GDGOONDAOPWNMHrH 


Re 


Note: If you are able to use logical partitions on your system, the Use 
Dedicated Service Tools screen will include option 11, Work with 
system partitions. 


4. If you are using logical partitioning, and you are restoring to the primary 
partition, you must restore your partition configuration before you restore 
storage. For secondary partitions, you will not restore the partition 
configuration — this step is only for primary partitions. Refer to 
Recover Your Logical Partition Configuration” on page 136}for instructions on 
restoring your partition configuration. Then return here and continue with the 
next step. 


5. Select option 9 (Work with save storage and restore storage) and press the 
Enter key. 


6. Select option 1 (Restore storage) and press the Enter key. The Specify Volume 
Identifier display is shown: 


Specify Volume Identifier 
Type choice, press Enter. 


Volume: Tdentifier: sey isc 2 eo eee Gece, 


7. Type the volume name in the Volume Identifier prompt. The volume name is 
SAVEDS. This is the volume that is currently loaded. You will be shown one 
of the following displays. Continue with the step that is indicated: 


Display Name Continue With This Step 


Select Tape Unit Step|8| 
Device Intervention Required Step|9 on page 314 


Confirm Restore Storage 


8. If the Select Tape Unit display appears, select the proper unit and press the 
Enter key. 
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- > 


Select Tape Unit 
Type option, press Enter. 
1=Select 
Serial 
Option Type Model Number Resource Name 
es 
Continue with step 


9. If the wrong volume is loaded, the following display appears: 


a = 


Device Intervention Required 


Deviicerty pei res c. teaesocyee tara mecousbet: lose avengers 
DeVaicenmodellievr) oes to ver water sees “cance pen «ton “eueeacs 


If the wrong volume was loaded, type change, press Enter. 


Type choice, press enter 
New volume or fille: << & Wee sa Wes we es 


Wrong volume loaded 


10. Type the name of the correct volume or file, and press the Enter key. The 
following display is shown: 


(iG ay 


Device Intervention Required 


Device: types. & aS wee Se oe we we ee OS 
Deviicerimodellinsees caches -setsine xe netletess cst cates ueenee 


Type choice, press enter 
AGE TOM ecomerrwencomewts saree etna carat crn en yes Fource nv sone ns 1=Cancel 


3=Retry 


ES ees 


11. Select option 3 (Retry), and press the Enter key. 


12. There is a delay while the tape is read to determine what has been saved on 
the tape. The Confirm Restore Storage display is shown. 
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ie _ 


Confirm Restore Storage 


Warning: A restore of storage will destroy the current data 
on the system. The restore will take several minutes for each 
unit saved. An automatic IPL is part of the restore. 


Press F1Q to confirm your choice to restore all storage. 
Press Fl2 to return to change your choice. 


w----- Restore To ------------------ ------ Saved From --------- 
Serial Resource Serial Resource 
Unit ASP Type Model Number Name Number Address 
ih 1 6602 030 00-0261624  DDQO3 00-0261624  DDO03 
3 5 6602 030 00-0211957 DDOOZ 00-0211957 DDO0Z 
SS e/ 


13. Press F10 (Confirm restore) to confirm. The restore status display on the 
console continually displays the progress of the restore operation. 


Function Status 


You selected to restore storage. 


51% Complete 
12 pages not readable 


The display indicates what percent of the total system sectors have been 
restored. However, this is an estimate and cannot be used to predict how long 
the entire restore procedure will take. 


14. If no errors occur, the system performs a programmed IPL when the restore 


storage process completes, go to|Task 4-Completing the Restore Storage 
Operation” on page 316] otherwise, continue to |“Task 3—Responding to 


Task 3—Responding to Messages 


While you are performing the restore storage operation, you may see the Device 
Intervention Required display or the Handle Tape Intervention display. 


When one of these displays appears, look for messages at the bottom of the 
display or for an I/O manager code on the display. Respond to the display by 
Fable 5é| 56 


using the information in 


Table 56. Handling Messages When Restoring Storage 


Message or Code 


Your Action 


End of tape encountered. Load next volume. Load the next tape volume. Select option 3 (Continue), and 


Tape unit not ready 


Wrong volume loaded 


press the Enter key. 

Make the tape unit ready, select option 3 (Continue), and press 
the Enter key. 

Remove the tape. Load the correct tape. Selection option 3 
(Retry) and press the Enter key. 


If the tape can not be read because of a media error, the following display is 
shown: 
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a > 


Restore Storage 
Status of restore: <3 ss 24-48 Se we ee Se a Ended 
A media error was found on tape. 


If this is the first time the restore storage has ended because 
a media error occurred on this tape, do the following: 

1. Remove the tape from the tape device. 

2. Clean the tape path using the cleaning procedure 

described in the tape device operator's guide. 

3. Press Enter, F3, or F1l2 to continue. The system will 
perform an IPL, an then display either the IPL or Install 
the System menu or the Missing Disk Units display. 

Select the option to use Dedicated Service Tools (DST) 

5. Select the option to Work with Save Storage and Restore 
Storage. 

6. Select the option Resume restore storage. 

7. Insert the tape which had the media error into the tape 
device. 

8. Make the tape device ready, if necessary. 


- 


(— Media Error While Restoring? 


For information on how to recover, see|“How to Resume the Restore Storage 
Operation” on page 319 


Task 4—Completing the Restore Storage Operation 


1. When the IPL completes after the restore storage operation, the IPL or Install 
the System menu appears. 


IPL or Install the System 
Select one of the following: 
1. Perform an IPL 
Install the operating system 
Use Dedicated Service Tools (DST) 
Perform automatic installation of the operating system 
Save Licensed Internal Code 


or wr 


2. Perform an attended IPL by selecting the Perform an IPL option. 


3. If the following display is shown, disk units have been attached to the system 
and are in nonconfigured status. 
Select option 3 (Add all disk units to the system auxiliary storage pool) and 


Add All Disk Units to the System 
Select one of the following: 
1. Keep the current disk configuration 
2. Perform disk configuration using DST 
3. Add all units to the system auxiliary storage pool (ASP) 
4. Add all units to the system ASP and balance data 


press the Enter key. 


As the disk units are being configured, the following display is shown: 
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Function status 


You selected to add units 
10% complete 


10. 


Adding disk units takes several minutes. The time it takes depends on the 
size of each unit and the number of units to be added. 


The Sign On display appears. Sign on as QSECOFR. 


Note: It is important that the following steps are performed so that the device 
resource names are updated correctly. 


At the IPL Options display, set the Start system to restricted state option 
to Y (yes). 


Note: As the IPL continues, SRC A900-2000 may appear. See [Recovering] 


from SRC A900 2000” on page 166} This section describes how to create 


a tape device descriptor so that the system hardware configuration can 
be restored in a later step of this procedure. 


When the IPL is complete, ensure that the system is in a restricted state. See 
You have to restore the configuration of your system. Use the most recent 
media volume that has your saved configuration. If you performed the 
Restore Storage on the same system that you did the Save Storage (SAVSTG) 
on, you were instructed to create a SAVCFG media volume before the 
SAVSTG ran. If your system configuration has changed since the Save Storage 
was performed, use the most recent SAVCFG or SAVSYS media volume. If 
you performed the Restore Storage on a system different than the system the 
Save Storage (SAVSTG) ran on, use the most recent SAVCFG or SAVSYS 
media volume from the system you restored to. The file on the tape is called 
QFILEIOC. 

Before you perform the RSTCFG command, you need to vary off all 
unnecessary configuration objects. Do not vary off the workstation and media 
drive that you are using to perform the resotre operation. 

With the SAVSYS or SAVCFG media volume loaded, type: 

RSTCFG OBJ(*ALL) DEV(media-device-name) OBJTYPE(*ALL) 

If you want the system to automatically configure new devices on subsequent 
IPLs, change the system value for QIPLTYPE to allow an unattended IPL. 
Type: 

CHGSYSVAL QIPLTYPE 'Q' 

It may be necessary to update the Network Attributes on the system. Get the 
latest list of the system’s Network Attributes. The instructions for the Save 
Storage (SAVSTG) command directed you to print the list of the Network 
Attributes and keep that list with the Save Storage tapes. To update the 
Network Attributes on the system, type the following and press the Enter key: 
CHGNETA 


Use the list of Network Attributes to enter the values on the input fields. 


Change the system value for QAUTOCFG to allow automatic configuration to 
run. Type: 


CHGSYSVAL QAUTOCFG '1' 
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11. 


12. 


13. 


14. 


15. 


Do a PWRDWNSYS *IMMED RESTART(*YES). 


;— Attention logical partitioning users! 
If you are going to use this command on the primary partition, be sure 
to power off all secondary partitions before running the command. 


If you have a problem with your devices, such as not being able to vary on a 
device, see |“Recovering Devices That Will Not Vary On” on page 237 


When you restore your information to a different system or an upgraded 
system, you may have a different console type on the target system. See 


“Recovering When You Change the Console Type” on page 238 


While the system is IPLing, you may see an error message about the 
System/36 environment, such as CPF3761. Refer to 
System/36 Environment Configuration” on page 239|for the procedure to 
follow after you have completed restoring storage. 


When the IPL completes, the restore history information for data area 

QSAVSTG in library QSYS is updated to show the date and time of the last 

restore storage operation. Use the Display Object Description (DSPOBJD) to 

display the last date and time of the restore storage operation. 

Use the Display Log (DSPLOG) command to display the QHST log or use the 

Display Messages (DSPMSG) command to display the QSYSOPR messages. 

Look at the restore storage message CPC3735 to determine if: 

* The system found any sectors that had data that could not be restored. The 
data may have been unreadable during the Save Storage operation. 


* The restore storage process is complete. 


If you have additional information to restore, such as SAVCHGOBJ tapes or 
journaled changes to apply, continue_with 
Otherwise, skip to 


Task 5—Restoring Additional Information 


If you are restoring changed objects, changed DLOs, or changed objects in 
directories, you must first restore user profiles. This builds the authority 
information for any new objects that you restore. If you are applying only 
journaled changes, start with step 


ale 
2. 


Sign on as QSECOFR. 


Put your system in a restricted state. See|“Putting Your System in a Restricted! 
State” on page 47 
Restore user profiles. See|“Restoring User Profiles” on page 222 


Restore changed objects and apply journaled changes. Follow the instructions 
in 


Chapter 11, “How to Restore Changed Objects and Apply Journaled 
Changes” on page 281 


Restore authority by typing: RSTAUT. 


Task 6—Restoring Program Temporary Fixes (PTFs) 
If you have applied PTFs since your SAVSTG procedure, follow the instructions in 
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;_ Stop! 
You have now completed restoring your system from SAVSTG media. 


How to Resume the Restore Storage Operation 


You can use this procedure to resume the restore storage operation that ended 
before the entire restore operation of the disk unit data was complete. 


To start the restore storage operation again, do the following: 


1. From the Dedicated Service Tools (DST) menu, select option 9 (Work with save 
storage and restore storage) and press the Enter key. 


2. Select option 2 (Resume restore storage) and press the Enter key. 


3. If the following display is shown, load the tape that is indicated and press the 
Enter key. 


Va 
Resume Restore Storage ) 


Do the following: 


1. Locate the tape to resume the restore on. The tape 
that was being read when the restore storage was 
interrupted has the following identification: 

Volume identifier ........: 
Sequence number .......4.3 
2. Insert the tape in the tape device. 
3. Make the tape device ready, if necessary. 


Note: 
If the restore storage was interrupted because of a media 
error on a tape, you may want to resume the restore 
storage on the tape following the failing tape. If you 
resume the restore storage on that tape, the system will 
have damaged objects, and the system might not be able to 
perform and IPL to 0S/400 when the restore storage is complete. 


Press Enter to continue. 


e 


4. If the wrong volume is loaded, the Device Intervention Required display with a 
message at the bottom is shown. Type the name of the correct volume or file, 
and press the Enter key. 


5. The restore storage operation starts again. 


If the restore storage operation continues to fail on the same tape with a tape 
media failure, you have three options: 


* Use a previous copy of your save storage tapes to completely restore storage. 
* Resume the restore storage operation by using the tape following the tape with 
the media error. If the tape that has the media error is the last tape to restore in 


the set, option 3 (Force end of an interrupted restore storage) on the Restore 
Storage menu should be selected. 
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Attention! 
Some disk unit data is not restored. There may also be many objects that 
are damaged on the system when the restore operation completes. An 
initial program load of the operating system may not be successful. You 
should restore the operating system again. 


* Initialize your system and then begin a restore of your system from the tapes 
that were created using SAVSYS and SAVLIB commands or options from the 
Save menu. 
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Part 4. Release-to-Release Support 


Chapter 15. Release-to-Release Support 

Current® Release-to-Previous Release Support 
Creating the Object for the Previous Release . 
Saving the Object for the Previous Release 
Testing the Object on the Current Release . 
Restoring and Using the Object on the Previous 
Release : 
Restrictions for Curent Release: fe Previus 
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Chapter 15. Release-to-Release Support 


The release-to-release support on the iSeries and AS/400e servers allows you to 
move data from the current release to a previous-release system. This support also 
allows you to move data from a previous-release system to a current-release 
system. 


Releases of licensed programs on the iSeries or AS/400e servers have a three-part 
name that consists of a version, a release, and a modification. For example, the 
current version is Version 5 Release 2 Modification 0. The short form of the current 
release name is V5R2MO. This chapter uses the short form for release names. 


Please read |”Restrictions for Current Release-to-Previous Release Support” onl 
ipage 331] and |“Restrictions when going from previous release to current release” on 


page 350] for important information. 


Current® Release-to-Previous Release Support 


This support enables objects (such as programs and files) that are created and 
saved on the current release to be restored and used on a previous release. Object 
compatibility is provided for many languages, and most object types are supported 
on both release levels as long as the objects use only functions from a previous 
release. 


You can enable current release-to-previous release support by using the target 
release (TGTRLS) parameter on create or save commands. 


Table 57} illustrates the TGTRLS parameter and values available for the current and 
previous releases. The values in the table are used throughout this chapter. Refer to 
this table to determine the valid values for the release currently on your system. 


Table 57. Values for TGTRLS Parameter 


Current OS/400 
Release *CURRENT *PRV Other Valid Values 
V5R2MO0 V5R2M0 V5R1MO V4R5MO 
V5R1MO V5R1MO V4R5MO V4R4M0 

V4R3M0 V4R2MO 
V4R5MO0 V4R5MO V4R4MO0 V3R2MO0 


Note: As of V5R1MO, you cannot target a save for an internal microprogram 
instruction (IMPI) based system. 


This support is extremely useful to: 

* A network enterprise with a central site development system on the current 
release and with remote sites still on the previous release. 

* An application development business with a single system on the current release 
that supports customers who may still be on the previous release. 


Current release-to-previous release support provides great savings and 
productivity improvements to application developers. By using this support, most 
network enterprises and application development businesses no longer need to 
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maintain two development systems. (For example, two development systems could 
contain a previous-release system that contains previous-release objects, or a 
current-release system that contains current-release objects.) In most cases, this 
support enables previous- and current-release objects to exist on one development 
system. 


The following sections describe how to create and save objects on the current 
release, and how to restore and use them on the previous release. 


Creating the Object for the Previous Release 


If you wish to run CL programs for a previous release, you must install option 9 
(*PRV CL Compiler Support) from OS/400. 


The following object types must be created specifically for a target release: 

* Program (*PGM) 

* Service program (*SRVPGM) 

* Module (*MODULE) 

* C locale description (*CLD) 

* SQL package (*SQLPKG) 

Create the object on the current release by using the appropriate create command 

with the TGTRLS parameter. All other object types can skip this step. If the object 
was created on, or is restored from, the previous release, and is not created again 

on the current release, you can skip this step. To determine what release the object 


was created on, use the DSPOBJD command and specify DETAIL(*SERVICE) to 
display the System-level value. 


It is recommended that previous-release programs and current-release programs be 
stored in separate libraries to simplify maintenance. Using the DSPPGM command, 
the Earliest release that program can run field shows if a program can be saved to the 
previous release. This recommendation also applies to previous-release and 
current-release modules and service programs. To determine if *MODULE objects 
can be saved to a previous release, use the DSPMOD command. To determine if 
*SRVPGM objects can be saved to a previous release, use the DSPSRVPGM 
command. 


Table 58} shows the languages and commands that support the TGTRLS parameter: 


Table 58. Language Support for the Target Release Parameter 


Language Command 


ILE C CRTBNDC 
CRTCMOD 
CRTCLD 


ILE C++ CRTBNDCPP 
CRTCPPMOD 


cics® CRTCICSC 
CRTCICSCBL 
CRTCICSGRP 
CRTCICSMAP 
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Table 58. Language Support for the Target Release Parameter (continued) 


Language 
CL 


ILE COBOL 


ILE RPG 


SQL 


Other 


Command 


CRTBNDCL 
CRTCLMOD 
CRTCLPGM 


CRTBNDCBL 

CRTCBLMOD 
CRTCBLPGM 
CRTS36CBL 


CRTBNDRPG 
CRTRPGMOD 
CRTRPGPGM 
CRTRPTPGM 
CRTS36RPG 
CRTS36RPT 


CRTSOLCI 
CRTSOQLCBL 
CRTSOQLCBLI 
CRTSOLCPPI 
CRTSOLPLI 
CRTSOQLRPG 
CRTSOQLRPGI 


CRTPGM 
CRTSRVPGM 


The following compilers are not available for V5R1MO and later or do not support 
the TGTRLS parameter: 


* BASIC 


* CL (S/38 Environment) 


* COBOL/74 (S/38 Environment) 
* FORTRAN/400 

¢ AS/400 Pascal 

¢ AS/400 PL/I 


* RM/COBOL-85 


¢ RPG/III (S/38 Environment) 


Saving the Object for the Previous Release 


You must save the object on the current release by using the TGTRLS parameter 
before restoring it on the previous release or previous modification. This saves the 
object in a format that is known to the previous release or previous modification. 


Use communication lines or removable storage media (tape, optical media volume, 
or diskette to move the objects from the current-release system). 


It is recommended that you store previous-release and current-release objects in 
separate libraries to simplify maintenance. 
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The following save commands support the TGTRLS parameter: 
* Save (SAV) 

* Save Calendar (SAVCAL) 

* Save Changed Objects (GAVCHGOB)J) 

* Save CICS Group (SAVCICSGRP) 

* Save Document Library Objects (GAVDLO) 

* Save DLO using BRM (SAVDLOBRM) 

* Save Folder List using BRM (SAVFLRLBRM) 

* Save Library (SAVLIB) 

* Save Library using BRM (SAVLIBBRM) 

* Save Licensed Program (SAVLICPGM) 

* Save Media Information using BRM (GSAVMEDIBRM) 
* Save Object (SAVOBJ) 

* Save Object by using BRM (SAVOBJBRM) 

* Save Object List by using BRM (SAVOBJLBRM) 

* Save/Restore Objects (SAVRST) 

* Save/Restore Changed Object (SAVRSTCHG) 

* Save/Restore Document Library Object (GSAVRSTDLO) 
* Save/Restore Library (SAVRSTLIB) 

* Save/Restore Object (GAVRSTOB)) 

* Save Ultimedia System Facilities Container (GAVUSFCNR) 


The System Manager licensed program uses the previous-release support provided 
by the SAVLICPGM command. It provides the capability to package software for 
multiple releases from the same system. 


Object compatibility is provided for most object types that are supported on both 
levels as long as the object only uses the previous-release function. 


‘Table 59} shows what object types can and cannot be specifically created or saved 
for a previous release. IBM does not support saving IBM-supplied objects (such as 


system commands and programs) from the current release and restoring them on a 
previous-release system. Refer to |Table 57 on page 323} for a list of supported 


TGTRLS values. 


Table 59] uses these values: 


* All means the object can be saved to all TGTRLS values that are supported on 
the current version of the operating system. 


* VvRrMm indicates the earliest release to which an object could be saved. 
However, you may need to refer to}Table 57 on page 323}to find the earliest 
TGTRLS value that is supported on the current version of the operating system. 


* *CURRENT means the object can only be saved to the current release, 
TGTRLS(*CURRENT). 


* None means the object is saved by a command, such as SAVSECDTA or 
SAVCIG, that does not support the TGTRLS parameter. 


Table 59. Previous-Release Support by Object Type 


Object Type Earliest Target Release 


*ALRTBL All 


326 0S/400 Backup and Recovery V5R2 


Table 59. Previous-Release Support by Object Type (continued) 


Object Type Earliest Target Release 
*AUTHLR None 
*AUTL None 
*BLKSF All 
*BNDDIR All 
*CFGL None 
*CHTFMT All 
*CHRSF V5R1MO 
*CLD All 
ICES All 
*CMD All 
*CNNL None 
*COSD None 
*CRG V4R4MO0 
*CROD All 

*CSI All 
*CTLD None 
*DDIR All 
*DEVD None 
*DIR All 
*DOC All 
*DSTMF All 
*DTAARA All 
*DTADCT All 
*DTAQ Alle 
*EDTD All 
*EXITRG All 
*FCT All 
*FIFO V5R1MO 
*FILE (database, device, save) All 
*FLR All 
*FNTRSC All 
*FNTTBL V3R7MO 
*FORMDF All 
*FTR All 
*GSS All 
*IGCDCT All 
*IGCSRT All 
*IGCTBL All 
*IMGCLG V5R2MO0 
*IPXD None 
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Table 59. Previous-Release Support by Object Type (continued) 


Object Type 


Earliest Target Release 


*JOBD All 
*JOBQ All 
*JOBSCD All 
*JRN All 
*JRNRCV ° All 
*LIB All 
*LIND None 
*LOCALE V3R7MO0 
*MEDDFEN V4R4M0 
*MENU All 
*MGTCOL V4R4M0 
*MODD None 
*MODULE! 
- ILEC All 
* ILE C++ All 
° ILECL All 
* ILE COBOL All 
* ILE RPG/400® All 
*MSGF All” 
*MSGO All 
*M36 V3R7MO0 
*M36CFG V3R7MO 
*NODGRP V3R2M0 
*NODL All 
*NTBD None 
*NWID None 
*NWSD None 
*OUTQ All 
*OVL All 
*PAGDFN All 
*PAGSEG All 
*PDG All 
*PGM: "2 
* BASIC *CURRENT 
* CL (S/38 environment) “CURRENT 
* CL (iSeries environment) All 
* COBOL (iSeries environment) All 
*CURRENT 


* COBOL/74 (S/38 environment) 
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Table 59. Previous-Release Support by Object Type (continued) 


Object Type Earliest Target Release 
* COBOL/74 ($/36 environment) All 

* ILEC All 

* ILE C++ All 

* ILECL All 

* ILE COBOL All 

* ILE RPG All 

* PASCAL *CURRENT 
° PL/I *CURRENT 
* RPG/TII (S/36 environment) All 

¢ RPG/III (S/38 environment) “CURRENT 
* RPG (iSeries environment) All 
*PNLGRP All 
*PRDAVL *CURRENT 
*PRDDFN All 
*PRDLOD All 
*PSFCFG V3R2M0 
*QMFORM All 
*QMORY All 
*QORYDFN All 

*RCT *CURRENT 
*SBSD All 
*SCHIDX All 
*SOCKET None 
*SPADCT All 
*SOLPKG All 
*SQLUDT V4R4M0 
*SRVPGM” 3 

* ILEC All 

¢ ILE C++ All 

* ILE CL All 

* ILE COBOL All 

+ ILE RPG/400 All 

*SSND All 

*STMF* All 
*SVRSTG V3R2M0 
*SYMLNK All 

*S36 *CURRENT 
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Table 59. Previous-Release Support by Object Type (continued) 


Object Type Earliest Target Release 
*TBL All 

*USRIDX All 

*USRPRF V5R1MOo0® 

*USRQ All 

*USRSPC All 

*VLDL V4R1MO 

*WSCST All 


1 


To move a program, module, or service program from a system that is running a PowerPC based release 
(Version 3 Release 6 Modification 0 or later) to a system that is running a non-PowerPC based release 
(V3R2 or earlier), the object must have observability. You can use the following commands to determine 
whether the observable information is stored with the object or has been removed: 


° Display Program (DSPPGM) 
° Display Module (DSPMOD) 
¢ Display Service Program (DSPSRVPGM) 


For ILE programs (a *PGM object created by binding one or more *MODULE objects together), the target 
release is determined by examining the target release value for each input *MODULE. If the target release 
values are different, the most recent target release value is used. An ILE program can be created from 
*MODULE objects created by different ILE compilers. The entries in this table for ILE languages under the 
*PGM object type state which target release values are supported by the ILE compiler when creating a 
*MODULE object. The *MODULE object can be used in turn to create an ILE program by using the 
CRTPGM command. 


For ILE service programs (a *SRVPGM object created by binding one or more *MODULE objects together), 
the target release is determined by examining the target release value for each input *MODULE. If the 
target release values are different, the most recent target release value is used. An ILE service program can 
be created from *MODULE objects created by different ILE compilers. The entries in this table for ILE 
languages under the *SRVPGM object type state which target release values are supported by the ILE 
compiler when creating a *MODULE object. The *MODULE object can be used in turn to create an ILE 
service program by using the CRTSRVPGM command. 


In V4R3, support was added for *STMF sizes up to 4gigabyte - Ibyte. A *STMF larger than 2gigabyte - 1 
byte cannot be saved to releases prior to V4R3. In V4R4, support was added for *STMF sizes greater than 
Agigabyte - lbyte. A *STMF larger than 4gigabyte - lbyte cannot be saved to releases prior to V4R4. 


If a journal receiver was attached to a journal when RCVSIZOPT(*MAXOPT1) was in effect, then it cannot 
be saved or restored to a release prior to V4R5MO. Also, it cannot be replicated to any remote journals on 
any systems at release prior to V4R5MO. If a journal receiver was attached to a journal when 
RCVSIZOPT(?*MAXOPT2) was in effect, then it cannot be saved or restored to a release prior to V5R1MO. 
Also, it cannot be replicated to any remote journals on any systems at releases prior to VSR1MO. If a 
journal receiver was attached to a journal when any MINENTDTA options were in effect, then it cannot be 
saved or restored to a release prior to V5R1MO. Also, it cannot be replicated to any remote journals an any 
system prior to VSR1MO. 


V4R5M0 is the earliest release for *DTAQ if the SIZE and AUTORCL parameters on CRTDTAQ did not 
contain the default values when the data queue was created. 


V4R5M0 is the earliest release if *UBIN or *BIN 8 is specified for the format of a message description 
within the message file. 


*USRPRF can only be saved to an earlier target release by using the Save Object List (QSRSAVO) API. See 
the iSeries Information Center (http://www.ibm.com/eserver/iseries/infocenter) for more information 
about QSRSAVO. 
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Testing the Object on the Current Release 


Once the object has been created and saved using the TGTRLS parameter it can be 
tested on the current-release system. Thus, it is no longer necessary to support and 
maintain two development systems (one running the current release and one 
running the previous version). Testing this object should be like testing any other 
object. Make sure that all the objects that are to be used on the previous-release 
system have been saved using the TGTRLS parameter, restored onto the 
current-release system, and tested as a group on the current-release system. 


Restoring and Using the Object on the Previous Release 


Once testing on the current-release system is completed, it is recommended that 
the object be distributed on a limited basis to previous-release systems or previous 
modification systems. Thus, if problems arise, they can be quickly corrected and 
contained with minimal impact to users. 


Restrictions for Current Release-to-Previous Release Support 


The following restrictions apply when you create and save objects on the current 
release, and then restore and use them on the previous release. 


* You cannot specify a TGTRLS value earlier than V4R5M0 to save data to optical 
media that you initialized with Universal Disk Format (UDF). 


* The System/38 environment compilers (CL, COBOL/74, and RPG/III) do not 
support the TGTRLS parameter. Programs that are created using these compilers 
cannot be saved to, restored, or run on a previous-release system. 


* The only way to save an object for a previous-release system is to use the 
TGTRLS parameter. If the TGTRLS parameter is not specified on the save 
command, and you attempt to restore the object on the previous-release system, 
the object is not restored. 


* IBM does not support saving IBM-supplied objects (such as system commands, 
system programs, IBM spelling aid dictionaries, and so forth) from a 
current-release system and restoring and using them on a previous-release 
system or previous modification. As a result, the TGTRLS parameter is not 
supported on a SAVLIB command that specifies *ALLUSR, *IBM, or *NONSYS 
on the LIB parameter. 


* IBM does not support new function from the current release to be used on a 
previous-release system or previous modification. 


* When saving document library objects for a previous release, only folders and 
filed documents can be saved. Other items, such as mail or documents that are 
not filed cannot be saved using TGTRLS values other than *CURRENT. 


* If a current-release program temporary fix (PTF) save file is sent from a current 
release-system to a previous-release system for distribution to another 
current-release system, object distribution must be used. The Copy PTF 
(CPYPTF) command or any save file command, such as DSPSAVF, cannot 
process the PTF save file. 


* When you save optical volume images, you cannot specify a value previous to 
V5R2M0 for the TGTRLS parameter on the SAV command. 
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Previous Release-to-Current Release Support 


—-— Moving All Your Data to the Current Release? 
This topic describes considerations when you are moving specific types of 
information from an earlier release to the most current release. Before you 
begin a data migration, refer to the Installation, upgrade and migration topic 
in the iSeries Information Center at 
http:/ /www.ibm.com/eserver /iseries /infocenter. 


Generally, the system to which you are restoring objects must be at the same or a 
higher release level than the system from which the objects were saved, unless you 
specified a target release value when you saved. When moving data to a higher 
level release, you should only move user data. This may include user libraries, 
user directories, user profiles, user objects in IBM-supplied libraries, DLOs, and 
mail. IBM-supplied libraries and IBM-supplied directories should not be restored 
to a higher release since these are handled during the licensed program install 
process. The target system should have the current-level release installed. This 
includes the Licensed Internal Code, OS/400 operating system, IBM-supplied 
libraries QGPL and QUSRSYS, OS/400 optional libraries, and any licensed 
programs that are purchased. See the Software Installation book to install the current 
release. 


Preventive service planning (PSP) information is available at the following Internet 
location: http://www. ibm. com/eserver/iseries/support/. Alternatively, you can 
obtain PSP information from your software service provider. You should check the 
PSP before beginning your server upgrade or data migration. The PSP identifier for 
information that pertains to upgrading your server or migrating your data is 
SF98166. Information within this PSP describes known high-impact and pervasive 
problems related to upgrades and migrations. To received this PSP information by 
using ECS, type this command on an iSeries command line: SNDPTFORD SF98166. 


Considerations when Moving System Customization 
Information 


Some system customization information that is stored in the QSYS library cannot 
be saved. This includes network attributes, system values, the system reply list, 
and configuration information. You must manually re-create this information on 
your new or upgraded system. In addition, you will not be able to recover your 


problem log and your question and answer database. Use the procedure that is 
Meceribecian |(Erinune syeiem information on pace d7io euni your cutters yale 
Restoring previous release user data to a new system 


The preferred method to restore previous release user data on your new, target 
system is to use the migration method. The migration method asks you to first 
install the new, current release onto your old, source system. After which, you save 
your old system and then you perform a full system recovery onto the new, target 
system. Only use these instructions if it is not possible to perform the preferred 
migration process referenced in the Installation, upgrade and migration topic in the 
iSeries Information Center at http://www.ibm.com/eserver/iseries /infocenter. 


This section provides instructions to restore user data from a previous-release 
system to a later release system. Look for supported releases for software upgrades 
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in the Software Installation book for your new, target release. This information 
explains for which releases you can use these instructions to restore your previous 
release user data to your new system. 


The restore procedure involves two save steps, and four recovery steps. The save 
steps include printing your system information and completely backing up your 
old, source system. 


The recovery steps on the new, target system involve the following four steps: 


1. Install Licensed Internal Code and OS/400 on the target system using new 
release distribution media. 


Note: If you order a new system (feature code 0205), the system arrives with 
the Licensed Internal Code and the base operating system (OS/400) 
preloaded on its disk units. Therefore, you can skip this step unless you 
are configuring a system with logical partitions. Then you will need to 
install the Licensed Internal Code and OS/400 on each secondary logical 
partition. Allow at least two additional hours to load the Licensed 
Internal Code and base OS/400. 


2. Restore system and user data to target system using the option 21 save of the 
source system. 


3. Update the system information on the target system. 


4. Install QGPL, QUSRSYS, Base options, and LPPs using new release distribution 
media on target system. 


This converts restored source data to new target release. 


Verify the prerequisites below and proceed to the step-by-step instructions to 
restore previous release user data to a new system. 
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Figure 29. Recovery steps for restoring previous release user data to a new system 


Prerequisites for the recovery... 
These instructions are sometimes used for a system upgrade when you install a 
replacement processor. 


You must perform the following prerequisite steps before you start the recovery 
portion of these instructions: 


* If available on your system, you run the RTVSYSINF command on the source 
system. Some releases of OS/400 do not support the RTVSYSINF command. 
When you run the RTVSYSINF command, the system asks you what library to 
use. Typically, you should specify the QUPGRADE library. If the QUPGRADE 
library does not exist, you should create it with the CREATE LIBRARY (CRTLIB) 
command. 


* If this is available on your system, you print system information with the 
PRISYSINF command on the source system. Some releases of OS/400 do not 
support the PRTSYSINF command. If your release does not support it, refer to 
the Backup and Recovery book for the release of your OS/400 for instructions 
on how to print the system information. 


* If necessary, save spooled files. For step-by-step instructions on how to save 
spooled files, see |‘Saving spooled files” on page 349 


Note: Job scheduler entries will not be restored. If necessary, make a note of 
your current job scheduler entries by using the Work with Job Schedule 
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Entries (WRKJOBSCDE) command and selecting the print option. Then 
you can recreate the job scheduler entries manually on the new system. 


* You run|Save menu option 21}of the GO SAVE command on the source system. 


Make sure that you specify the following options: 
1. Vary off the network servers...*ALL 
2. Unmount file systems............ Y 
* You have a copy of the distribution media for the target system. 


* If you want to restore data to logical partitions on your target system, you have 
already configured the logical partitions. See the iSeries Information Center at 
http:/ /www.ibm.com/eserver/iseries/infocenter for instructions to create logical 
partitions. 


* If required, you set up device parity protection and load source mirroring on the 
target system. If you have not done so on the new system, consult an iSeries and 
AS/400e specialist to configure your DASD for your level of mirroring, and 
parity protection before you continue with these instructions. 


Restoring previous release user data to a new system: 
Step-by-step instructions 

Perform the following steps on the new, target system. You will first install only 
the Licensed Internal Code and the OS/400 operating system from the I_Base 
distribution media for the target release. Do not install any of the base options or 
LPPs at this time. 


Note: If you have ordered a new system with feature code 0205, go to step[25 on| 
page 344 


age 344]after you have referred to the Installation, upgrade and migration 
topic in the iSeries Information Center at 
http:/ / www.ibm.com/eserver/iseries /infocenter. 


Check off each item as you complete the task on the target system. 
AF 


If you use Operations Console with LAN connectivity, you must disconnect 
Operations Console from the server, resynchronize your PC device ID, then 
connect to Operations Console, to be the same as the iSeries device ID. If 
you are resynchronizing V5R2 Operations Console, use the following 
instructions. If you are resynchronizing a previous release of Operations 
Console, see the Operations Console topic in the iSeries Information Center 
at http:/ /www.ibm.com/eserver/iseries /infocenter. 


a. If Operations Console is connected to the server, select the connection 
name in Operations Console that you will be making the change for, 
then click Connection --> Disconnect. 


b. Select the connection name that you will be making the change for, then 
click Connection --> Properties. 


a. Select the Device ID tab. 


b. Specify the appropriate passwords in the Password and Confirm 
password fields, then, click OK. 


c. Specify the correct Access password and click OK. 


d. Select the connection name that you the changed, then click Connection 
--> Connect. 
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If you are using Operations Console, LAN or direct connect, disconnect from 
your server and close Operations Console. Restart Operations Console and 
reconnect by using the user ID of 11111111 and password of 11111111 to sign 
on to your server. 


3. IPL the system from the first distribution media. 


__a. Mount the first distribution media on the alternate IPL device. Wait 
for the READY status. 


At the CPU control panel, place the system in MANUAL mode. 


Press the Function Select switch (or buttons) to display 02 (IPL) in the 
Function display. 


Press Enter. 


Press the Function Select switch (or buttons) to display D (IPL from 
tape or CD-ROM) in the Data display. 


f. Press Enter. 


__g. If the system is powered down, press the power button on the system 
to power the system on. Skip to Step [6] Otherwise, continue with Step 
Bh 


h. If the system is powered on, press the Function Select switch (or 
buttons) to display 03 (continue the IPL) in the Function display. 


__i. Press Enter. 


4. The Select a Language Group screen displays the primary language feature 
that is currently on your distribution media. Press Enter to accept this value. 


( >) 


Select a Language Group 


Note: The language feature shown is the language feature 
installed on the system. 


Attention: To keep the same primary language, ensure that the 
media you use for installing the operating system 
matches the language feature shown. If the operating 
system media does not match what is shown, the 
installation process will attempt to install the 
operating system in a different language feature than 
Licensed Internal Code. This is undesirable. 
Type Choice, press Enter. 


Language: Features... 6 2.2. se 2924 
Ne ef 


5. The Confirm Language Feature Selection screen appears. Press Enter to 
continue. 

6. On the Install Licensed Internal Code (LIC) screen, select option 1 to Install 
Licensed Internal Code. Then select 2, Install Licensed Internal Code and 
Initialize system, to start the install of the Licensed Internal Code. 
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ie _ 


Install Licensed Internal Code (LIC) 
Disk selected to write the Licensed Internal Code to: 
Serial Number Type Model 1/0 Bus Controller Device 
XX=XXXXXXX XXXX XXX x Xx Xx 
Select one of the following: 
1. Restore Licensed Internal Code 
2. Install Licensed Internal Code and Initialize System 
3. Install Licensed Internal Code and Recover Configuration 
4. Install Licensed Internal Code and Restore Disk Unit Data 
5 


. Install Licensed Internal Code and Upgrade Load Source 


Selection 
2 
NS e/ 


__7. On the Install LIC and Initialize System - Confirmation screen, press F10 to 
confirm the initialization and to continue the install. 


(— s 


Install LIC and Initialize System - Configuration 
Warning: 


All data on this system will be destroyed and the Licensed 
Internal Code will be written to the selected disk if you 
choose to continue the initialize and install. 


Return to the install selection screen and choose one of the 
other options if you want to perform some type of recovery 
after the install of the Licensed Internal Code is complete. 


Press F10 to continue the install. 
Press F12 (Cancel) to return to the previous screen. 
Press F3 (Exit) to return to the install selection screen. 


__a. The Initialize the Disk - Status screen appears. 


Initialize the Disk - Status 
The load source disk is being initialized. 


Estimated time to initialize in minutes: xx 
Elapsed time in minutes. ....... 2 020 


__b. The Install Licensed Internal Code - Status screen appears. 


Install Licensed Internal Code - Status 


Install the Licensed Internal Code in progress 


Percent Complete ..... 0% 8.5 minutes 
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__ 8. On the Disk Configuration Attention Report screen, press F10 to accept any 
problems and to continue. 


fe : > 
Disk Configuration Attention Report 


Type option, press Enter 
5=Display Detailed Report 


Press F1Q to accept all the following problems and continue. 
The system will attempt to correct them. 


OPT Problem 
_ New disk configuration 


F3=Exit Fl0=Accept the problems and continue ) 


__ 9. On the IPL or Install the System screen, select 3, Use Dedicated Service Tools 


(DST). 
Va 
IPL or Install the System > 
Select one of the following: 
1. Perform an IPL 
2. Install the operating system 
3. Use Dedicated Service Tools (DST) 
4. Perform automatic installation of the operating system 
5. Save Licensed Internal Code 
Selection 
3 
NS / 


__ 10. Sign on to DST as DST user, QSECOFR, with the password QSECOFR. The 
password is case sensitive; use all capital letters. 


Dedicated Service Tools (DST) Sign On 


Type choices, press Enter. 


DST User QSECOFR 
DST password 


a. Select option 4, Work with Disk Units. 

b. Select option 1, Work with Disk Configuration. 

c. Select option 3, Work with ASP Configuration. 

d. Select option 3, Add Units to ASPs. 

__ 11. On the Specify ASPs to Add Units to screen, enter "1" for each unit that 
needs to be in the System ASP (ASP 1). 
__a. If you require more than one ASP, enter the corresponding ASP 

number on each selected unit. 
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ea 


Specify ASPs to Add Units to 
Specify the ASP to add each unit to. 
Specify Serial Resource 
ASP Number Type Model Capacity Name 
1 00-0103706 6602 030 1031 DDO31 
1 00-1000341 9337 211 542 DDO12 
1 00-5000341 9337 211 542 DDO15 
1 00-7000341 9337 211 542 DDO11 
1 00-3000341 9337 211 542 DDO14 
1 00-2000341 9337 211 542 DDO13 
1 = 00-61300 6603 074 1475 DD006 
1 00-52262 6606 074 1475 DDO08 
1 00-86978 6606 050 1967 DDO09 
2  00-95744 6603 074 1475 DDOO5 
2  00-47657 6606 074 1475 DD007 
-  00-0238703 6602 074 773 =DDO51 
- 00-0128350 6602 074 773 DDO51 


__b. After you complete all units, press Enter. 


__c. If the list of units is correct, press Enter to start initializing the units. 


__ 12. On the Problem Report screen, press F10, Ignore problems and continue. 


i 


Problem Report 


Note: Some action for the problems listed below may need to 
be taken. Please select a problem to display more detailed 
information about the problem and to see what possible 
action may be taken to correct the problem. 


Type option, press Enter. 
5=Display Detailed Report 


OPT Problem 
_ Unit possibly configured for Power PC AS 


F3=Exit F10=Ignore problems and continue F12=Cancel 


z 


__ 13. On the Confirm Add Units screen, press Enter to confirm the selected units. 
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(~ Confirm Add Units >) 


Add will take several minutes for each unit. The system will 
have the displayed protection after the unit(s) are added. 


Press Enter to confirm your choice for 1=Add units. 
Press F9=Capacity Information to display the resulting capacity. 
Press Fl2=Cancel to return and change your choice. 


Serial Resource 
ASP Unit Number Type Model Name Protection 


1 Unprotected 
00-0103706 6602 030 DO31 Unprotected 
00-1000341 9337 211 DO12 Unprotected 
00-5000341 9337 211 DO15 Unprotected 
00-7000341 9337 211 DO11 Unprotected 
00-3000341 9337 211 DO14 Device Parity 
00-2000341 9337 211 D013 Device Parity 
00-61300 6603 074 DOO6 Device Parity 
00-52262 6606 074 D008 Device Parity 
00-86978 6606 050 D009 Device Parity 
2 Unprotected 
10 00-95744 6603 074 DOO5 Device Parity 
00-47657 6606 074 DOO7 Device Parity 


WOONDAOTAHPWNHPEHE 
Red SS a SS 


i=) 


=j 
= 
= 


a. The Function Status screen displays the percentage of completion. 

b. The "Selected units have been added successfully" message appears 
when the system completes the Add Units process. 

c. Press F12 to return to the Work with Disk Configuration screen. 

d. If your system requires mirrored protection, continue to Step [13e] If 


your system does not require mirrored protection, press F3 until you 
exit the Dedicated Service Tools (DST) screen. 

e. To start mirrored protection for your system, follow these 
instructions: 
__ 1) On the Work with Disk Configuration screen, select 4, Work 

with Mirrored Protection. 

__ 2) On the Work with Mirrored Protection screen, select 2, Start 
Mirrored Protection. 

3) Select an ASP by placing a 1” next to it. Press Enter to start 
mirrored protection. 

4) On the Confirm Continuation screen, press Enter. 

5) On the Confirm Start Mirrored Protection screen, press Enter. 

6) The Function Status screen displays the completion status of 
the Start Mirrored Protection request. 

7) The Start mirroring completed successfully message appears on 
the Disk Configuration Information Report screen. 

8) Press Enter to continue. 


f. If you use Operations console, follow these instructions to switch 
from ‘local console’ to ‘operations console’: 
__ 1) On the IPL or Install the System screen, select 3, Use Dedicated 
Service Tools (DST). Press Enter to continue. 
2) Sign on to DST as using a service tools user profile that has 
security officer authority and the assigned password. 


__ 3) On the Use Dedicated Service Tools (DST) screen, select 5, Work 
with DST environment. Press Enter to continue. 
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__ 4) On the Work with DST Environment screen, select 2, System 
Devices. Press Enter to continue. 

5) On the Work with System Devices screen, select 6, Console 
Mode. Press Enter to continue. 

6) On the Select Console Type screen, select 2, Operations Console 
or option 3 Operations Console (LAN). Press Enter to 
continue. 


7) If you select option 3, Operations Console (LAN), press F11 to 
configure the LAN console. 


8) Press F3 or F12 to get back to the IPL or Install the System 

screen. 

14. Load the first volume of installation media that contains OS/400. (This 
volume is labeled B29xx_01, where 29xx is the identifier for the primary 
language.) 

When you are installing from optical media, wait until the In Use indicator 
goes out before you continue. 


__ 15. On the IPL or Install the System screen, select 2, Install the Operating 
System. 


fe 
IPL or Install the System ) 


Select one of the following: 


. Perform an IPL 

Install the Operating System 

Use Dedicated Service Tools (DST) 

Perform automatic installation of the Operating System 
Save Licensed Internal Code 


OarWNr 


Selection 
2 
SS aay 


__a. Make a selection on the Install Device Type Selection screen and press 
Enter. 


Install Device Type Selection 
System: XXXX 
Select the installation device type: 


1. Tape 
2. Optical 
3. Virtual optical - preselected image catalog 


__b. On the Confirm Install of OS/400 screen, press Enter. 
__ 16. Make your selection on the Add All Disk Units to the System screen. 
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(a 
Add All Disk Units to the System 


Non-configured device parity capable disk units are attached 
to the system. Disk units can not be added automatically. 

It is more efficient to device parity protect these 

units before adding them to the sytem. 

These disk units may be parity enabled and added at SST (XPF). 
Configured disk units must have parity enabled at DST. 


Select one of the following: 
1. Perform any disk configuration at SST (XPF) 


2. Perform disk configuration using DST 


Selection 


Note: This screen does not appear if_you selected all disk units that are 
known to the system on Step|11 on page 338 


__17. The Licensed Internal Code IPL in Progress screen displays the IPL progress. 


a 
Licensed Internal Code IPL in Progress > 
IPL: 
TYPO soe oe ww) ess Attended 
Start date and time . xx/xx/xx XxX:Xxx:xx 
Previous system end . Normal 
IPL Step ..... .. 3: Storage Management Recovery 
XX ey 
__ 18. On the Install the Operating System screen, select option 1, Take defaults. 
Make sure that the values for Date and Time are correct. Press Enter to 
continue. 
ii 
Install the Operating System *) 
Type options, press Enter. 
Install 
Option... % eis = 1 l=Take defaults (No other 
options are displayed) 
2=Change install options 
Date 
NiG@aNe tee scent one 03 00-03 
Monthes 2 2: ane 08 01-12 
Daven urine. 22 01-31 
Time 
HOU eats Yeln sone. oe 16 00-23 
MiNUte> <x. oe 45 00-59 
S@CONd 2 5, = vs 00 00-59 


__ 19. The OS/400 Installation Status screen displays the installation status of the 
required OS/400 Installation Profiles and Libraries. 


342 0S/400 Backup and Recovery V5R2 


Se 
Message ID . . : CPI2070 0S/400 Installation Status 


Gh te ee eee eee es a ee = ea a ee a + 
Stage 1 |XXxXXXXXXXXXXXXXXXXXXXXXXXKXKAXAXXXAKXXXX XXX AX KXKXKAKAXAKXKAKAXKXKAXAXKXKAXAXAX | 
Sa a a ee + 
0 20 40 60 80 100 
Installation Objects 
Stage Completed Restored 


Creating needed profiles and libraries .. .: 
Restoring programs to library QSYS.....: 
Restoring language objects to library QSYS .: 
Updating jprogram:tabilie= ss. -..6) es es ve: ee, ett 
Tnstaliiing database: filles a0. 3.28 Soe et 
Completing OS/400 installation. ......: 


eT Ora 


__ 20. The system installs the remaining OS/400 objects. 


éé 
Message ID . . : CPI2070 0S/400 Installation Status 


Installation Objects 
Stage Completed Restored 


Creating needed profiles and libraries .. .: 
Restoring programs to library QSYS.... .: 
Restoring language objects to library QSYS .: 
Updating program table... eo ee 
Install Ving) database: files: 22.206 55 26x 
Completing OS/400 installation... ....: 


09 
03 


x Kx KK XK 


(Gra or ae 


yf 


__21. On the Sign On screen, logon as user QSECOFR. You do not need to enter a 
password at this time. 


22. On the IPL options screen, enter correct values for Date and Time. Only the 
following options should be set to Y: 


* Start system to restricted state 
* Set major system options 
* Define or change the system at IPL 


ti 
IPL Options +) 
Type choices, press Enter. 
Systemedate™ (cc) creamer eh aise Ore tee 08/22/99 MM/DD/Y 
System time: <4 3 www ea Se we 16:58:00 HH:MM:S 
Clear job iqueues: sn =. ttc cs, cap ds eae ce N Y=Yes, N=No 
Clearcoutputqueues 2.22 e25 oe ee) ee N Y=Yes, N=No 
Clear incomplete job logs ........ N Y=Yes, N=No 
Stantrprimbeweiters: ce oe csc cue wer capeds eo ee N Y=Yes, N=No 
Start system to restricted state ..... Y Y=Yes, N=No 
Set major system Options... <3 tes so 4. te Ni Y=Yes, N=No 
Define or change system at IPL. ..... NY Y=Yes, N=No 
Ne e 
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__a. On the Set Major System Options screen, select N to not enable 
automatic configuration. 


( Set Major System Options *) 


Type choices, press Enter. 


Enable automatic configuration. ..... N Y=Yes, N=No 
Device configuration naming ....... *NORMAL *NORMAL, *S36, 
*DEVADR 
Default special environment. ....... *NONE *NONE, *S36 
= yy 


__ 23. The Define or Change the System at IPL screen appears. 
__a. Select 3, System value commands. 


__b. On the System Value Commands screen, select 3, Work with System 
Values. 


c. On the Work with System Values screen, select the System Value that 
you plan to change by placing a "2" next to it. Press Enter ONLY 
after you select all the values. 


Update the following System Values. Write down the existing values 
so you can update them after the recovery, if necessary. 


* Change QALWOBJRST to *ALL 

* Change QIPLTYPE type to 2 

* Change QJOBMSGQEL to *PRTWRAP 

* Change QJOBMSGQMxX to a minimum of 30 
* Change QPFRADJ to 2 

* Change QVFYOBJRST to 1 


d. After the system changes the system values, press F3 twice to return 
to the Define or Change the System at IPL screen. 

e. On the Define or Change the System at IPL screen, press F3 to exit and 
continue the IPL. 

___ 24. On the Change Password screen, type QSECOFR as the current password. 


Enter a new password. Re-enter the password to verify and press Enter. 
(New password cannot be QSECOFR.) 


(e > 


Change Password 
Password last changed ...... xX/XxX/XX 
Type choices, press Enter. 
Current. password’ .. 5 ve: co. Ve) ve, 8) ce QSECOFR 


New password... 3 3 i. 40 8 6 a4 
New password (to verify) ..... 


___25. Because you have not selected automatic configuration, you must 
manually configure a tape drive to perform the following restore step for 
your user data and related system data. 


__a. To configure 3422, 3430, 3480, or 3490 tape units, follow these 
instructions. If you have a 3490 Model E or F or to configure other 


types of tape units, go to step |25b on page 346 
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1) Use the Work with Hardware Resource (WRKHDWRSC) 
command to determine the location of the tape controller. 


WRKHDWRSC TYPE (*STG) 


Create the controller description for the tape controller by doing 
the following: 


2) 


a) 


oO Ff 
~~ a 


= 


2 


= 


= 
a= 


Locate the resource name for the tape controller on the Work 
with Storage Resources display. The value 34xx is displayed 
in the Type column. 


Write down the name of the resource. 


Type a 9 (Work with resource) in the Opt column next to 
name of the tape controller and press the Enter key. You see 
the Work with Storage Resources display. 


Note: If the resource is not listed on the display, you need to 
select other resources, such as disk storage controllers. 
For some server models, resources are now attached 
through combined-function IOPs. Look through the 
resources until you find the device you want. 

Type 5 (Work with controller descriptions) in the Opt column 

in front of the tape controller. You see the Work with 

Controller Description display. 

Type 1 (Create) in the Opt column on the top line. 

Type the controller name (such as TAPCTLO1) in the 

description field and press the Enter key. You see the Create 

Controller Description display. 

If necessary, type additional information on the display. Then 

press the Enter key. You return to the Work with Controller 

Descriptions display. 

If the controller description that you created does not appear, 

press F5 (Refresh). 


To create device descriptions for the tape units that are attached 
to the controller, do the following: 


a) 


o 
a 


(?) 
~ 


2S 


c 


= 
a4 


On the work with Controller Descriptions display, press F23 
(More options). The list of options changes. 

Type 9 (Work with associated descriptions) in the Opt column 
in front of the new tape controller. You see the Work with 
Associated Descriptions display. 

Locate the resource for the tape unit. Because no device 
description exists, the description says *NONE. 

Write down the name of the tape resource. 

Type a 1 (Create) in the Opt column next to the description of 
*NONE and press the Enter key. You see the Create Device 
Desc (Tape) (CRTDEVTAP). 

In the Device description field, type a name such as TAPO1. 


In the Resource name prompt, type the name that you wrote 
down in step |25a3d (If you did not write it down, press F12 


to return to the display. Repeat steps |25a3d) through |25a3g}) 


Press the Enter key. 


i) Additional parameters appear on the display. 
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4) 


j) If necessary, type additional information on the display. Then 
press the Enter key. You return to the Work with Associated 
Descriptions display. 

k) Press F5 (Refresh). The name of the description that you 
created should now be associated with the resource. 


1) Type 8 (Work with configuration status) in front of the 
controller description and the device description. You see the 
Work with Configuration Status display. 

m) Type 1 (Vary on or Make available) in front of the controller 

and the devices. 


Press F3 until your return to your original menu. 


__b. To configure tape units that are not models 34xx, use the following 
instructions: 
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1) 


2) 


Use the Work with Hardware Resource (WRKHDWRSC) 
command to determine tape controller name. 


WRKHDWRSC TYPE(*STG) 

Locate the tape controller on the Work with Storage Resources 
display. 

Type a 9 (Work with resource) next to tape controller name and 
press the Enter key. 


Note: If the tape controller is not listed on the display, you 
need to select other resources, such as disk storage 
controllers. For some server models, tape units are now 
attached through combined-function IOPs. Look through 
the resources until you find the tape unit you want. 


Locate the resource name for the tape unit (in most cases it is 
TAPO1). 


Enter a 5 (Work with Configuration Descriptions) in the Opt 
column next to the tape resource name and press the Enter key. 


You are shown the Work with Configuration Descriptions 
display. 

Type a 1 (Create) in the Opt field and a tape device description 
name (for example, TAPO1) in the Description field. Press the 
Enter key. You are shown the Create Device Description (Tape) 
display. 

Change any values that you want to change, then press the 
Enter key (twice) to create the device description. You are 
shown the Work with Configuration Descriptions display again. 
The device that you created should appear on the display. 


Type an 8 (Work with configuration status) in front of the new 
device description. You are shown the Work with Configuration 
Status display. 


Type a 1 (Vary on or Make available) in front of the new device. 
If the status does not change to Varied On or Available, wait a 
few minutes. Then press F5 (Refresh). If the status still does not 
change to Varied On or Available, follow normal problem 
analysis for the device. 


Press F3 until you return to the main menu. 


(o 


OrPrWoOOnNnNOAOPWNYE 


or 


=> 


Select one of the following: 


. User tasks 

. Office tasks 

. General system tasks 

. Files, libraries, and folders 
. Programming 

. Communications 

. Define or change the system 
. Problem handling 

. Display a menu 

. Client Access/400 tasks 

. Sign off 


Selection or command 


0S/400 Main Menu 


___26. Use the save media of the option 21 save from the source system to 
perform the following steps to restore the user data and related system 
data, and user data to the target system: 


a. ENDSBS SBS(*ALL) OPTION(*IMMED) 
b. Prevent messages that are not necessary by typing: CHGMSGQ 


MSGQ(QSYSOPR) DLVRY(*NOTIFY) SEV(99) 


c. RSTUSRPRF DEV(media-device-name) ALWOBJDIF(*ALL) 


ENDOPT (*LEAVE) 


d. RSTCFG OBJ(*ALL) DEV(media-device-name) OBJTYPE(*ALL) 


SRM(*NONE) ALWOBJDIF(*ALL) ENDOPT(*LEAVE) 


e. RSTLIB SAVLIB(*NONSYS) DEV(media-device-name) OPTION(*NEW) 


ALWOBJDIF(*ALL) MBROPT(*ALL) FRCOBJCVN(*NO) ENDOPT(*LEAVE) 


Note: 


This command does not restore the QAUDJRN and 
QACGJRN objects and any job scheduler entries. 


f. RCLDLO *ALL 


__g. RSTDLO DLO(*ALL) DEV(media-device-name) SAVFLR(*ANY) 
ALWOBJDIF(*ALL) ENDOPT(*LEAVE) 


Note: 


If you have DLOs in any of your user ASPs, you need to use 
the following command to restore DLOs to each user ASP: 
RSTDLO DLO(*ALL) ALWOBJDIF(*ALL) SAVASP(ASP-number) 
RSTASP (ASP-number) 


h. RST DEV('/QSYS.LIB/media-device-name.DEVD') OBJ(('/*') 


('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT)) ALWOBJDIF(*ALL) 


i. To restore spooled files that you saved on your source system, do the 


following: 


='N) 


2) 


In|Saving spooled files” on page 349} you saved spooled files 


to database files in a library. If that library has not yet been 
restored to your upgraded system, restore it now by using the 
RSTLIB command. 


Note: Use the RSTLIB command only if you used the SAVLIB 
command to save the objects. If you used the SAVOBJ 
command, you must use the RSTOBJ command. 


For each spooled file that you need to restore, do the 
following: 
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27. 


28. 


29. 
___ 30. 


31. 


__ 32. 


__a) On the printout that you used when you saved the 
spooled files, locate the name of the printer file that was 
used to create the spooled file. It appears in the File 
column on the left side of the printout. 

__b) To override the control character value for the QPRINTS 
file, type the following command: OVRPRTF 
FILE(QPRINTS) CTLCHAR(*FCFC) 

c) Copy the database file to the printer file by typing the 
following: CPYF FROMFILE(LIBSPLF/SPOOLF1) 
TOFILE(QGPL/QPRINTS) MBROPT (*REPLACE) 

In this example, a spooled file named QPRINTS is 
placed on the output queue that is associated with the 
definition for the QPRINTS printer file. 

d) Delete the database file by using the Delete File (DLTF) 
command. 


3) When you restored all spooled files, delete the override for the 
QPRINTS file by typing the following: DLTOVR FILE(QPRINTS) 


If you used the RITVSYSINF command on the source system, you must 
now run the UPDSYSINF command to update the system information on 
the target system. 


If your source system does not support the RTVSYSINF command, you 
need to use the printed system information to update all system 
information such as system values, message reply lists entries, etc. on the 
target system. 

The RIVSYSINF command does not update all system information. Use the 
printed system information to update additional system information such 
as access path recovery times, subsystem descriptions, RJE configurations, 
etc. 

Install the base options (including QGPL and QUSRSYS) and other licensed 
programs using the distribution media for the target system (current 
release) and the GO LICPGM command. Ensure that your optical 
installation is varied on. Refer to the Software Installation book for your 
target release. At V5R2, see Chapter 4. Replacing a Release Using Manual 
Installation. Skip to Task 3. Replacing the Licensed Programs. Begin with 
step 5, The iSeries Main Menu appears on your console. Do not continue 
with the Checklist for Completing the Installation until instructed to do so. 
Run the RSTAUT command. 


If necessary, change the following system values back to their original 
values by using the WRKSYSVAL command: 


* QALWOBJRST 

* QOIPLTYPE 

* QJOBMSGOFL 

* QJOBMSGOQMX 

* QPFRADJ 

* OVFYOBJRST 

If you do not know the password for the restored QSECOFR profile, 
change the password before signing off. Type the following command: 
CHGUSRPRF USRPRF(QSECOFR) PASSWORD (new-password) 

Type the command, DSPJOBLOG *PRINT. Check the job log to ensure that the 
job restored all objects. To verify if the job restored all objects, spool the job 
log for printing along with any remaining spooled job output. Check for 
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___ 33. 


34. 


___ 35. 


any error messages. Correct the errors and restore those objects from 
media. If you are using this checklist as part of a data migration, return to 
the iSeries Information Center at 
http://www.ibm.com/eserver/iseries/infocenter: Installation, upgrades, 
and migration —> Migration —> Perform the migration -> Complete the 
migration from a 4xx or 5xx server. 


Complete the installation. Refer to the Software Installation manual for 
your target release. Follow the instructions in the chapter that contains the 
Checklist for Completing the Installation. It instructs you to Install the 
cumulative PTF package; when you do this, accept the default option to 
perform an IPL of the system. 
Add job scheduler entries with the ADDJOBSCDE command using the 
information you printed from your source system. Use the Work with Job 
Schedule Entries (WRKJOBSCDE) command and select the print option. 
If you installed iSeries Integration for Windows® Server on your system 
and you saved with your network servers in a VARIED OFF setting, 
perform the following steps: 
__a. Add the links for the server descriptions. Type the following for 
each server description: 


ADDNWSSTGL NWSSTG(Storage Name) NWSD(Server_ Description) 


b. Vary on your network servers by typing WRKCFGSTS *NWS and 
selecting option 1 to vary on each network server. 


Saving spooled files 

When you save a library that contains output queues, you save the descriptions of 
the output queues but not their contents. If you have critical spooled files that you 
will need after the upgrade procedure, you can use the following procedure to 
save them: 


— ik 


Create a library to hold copies of the critical spooled files by using the 
CRTLIB command. For example, to create a library called LIBSPLF to hold 
your spooled files, type the following: CRTLIB LIB(LIBSPLF) 


Note: If the spooled files contain confidential information, specify 
AUT (*EXCLUDE) on the CRTLIB command. 


. Use the Work with Output Queue command to locate the spooled files that 


you want to save from a designated output queue: WRKOUTQ 
OUTQ(1ib-name/queue-name) OUTPUT (*PRINT) 


Note: If you do not have special output queues that are designated for 
critical spooled files, type WRKOUTQ OUTQ(*ALL) 


Print out and retrieve the listing of the spooled files that you need to save. 
On the printout, mark the spooled files that you need to save. 
For each spooled file, do the following: 


__a. Choose a name (8 characters or less) for the spooled file that will help 
you to identify it. Each file should have a unique name. 


b. Create a database file to hold the contents of the spooled file by 
typing the following: CRTPF FILE(LIBSPLF/file-name) RCDLEN(133) 
Notes: 

1) For file-name, substitute the name that you assigned in step 
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2) Use an appropriate record length for the spooled file that you are 
copying. The record length must be at least 1 character larger than 
the spooled data to allow for the control character. 


3) If you are copying a large spooled file, specify SIZE“#NOMAX) 
when you create the database file. 


Copy the contents of the spooled file to the database file that you 
created by typing the following: CPYSPLF FILE(spooled-fi le) 
TOFILE(LIBSPLF/file-name) JOB(job-number/user-name/job-name) 
SPLNBR(nnn) CTLCHAR(*FCFC) 


Note: For spooled-file, substitute the value from the File column on 
the listing that you created in step |2 on page 349 


You may receive message CPA3312 if the spooled file contains special 
attributes. Respond with G (GO) to continue saving the contents of 
the spooled file. 

If you need to save special attributes associated with spooled files 
(such as advanced function attributes), see the ’AS/400 Road Map for 
Changing to PowerPC Technology’ for more information. You receive 
a confirmation message that the data has been copied. 


__ 6. Repeat step 5 on page 349} steps|5a on page 349] through step for each 


spooled file that you need to save. 


7. If you 


have additional output queues to process, return to}2 on page 349 


8. Use the SAVLIB command to save the library that contains the copies of 


your spooled files. 


Restrictions when going from previous release to current 


release 


To avoid data loss, if you have any of these products installed on your system, 
please read this notice before upgrading to OS/400 Version 5, Release 1 or any 


later release: 


* 5639L47 - IBM DB2® Family Fundamentals - Distance Learning 

* 5648C69 - IBM CallPath® Server for AS/400 

* 5648D31 - WebSphere® Host Publisher Version 4.1 

* 5648GL1 - SanFrancisco'’ General Ledger 1.4 

* 56480M1 - SanFrancisco Order Management 1.4 

* 5648RP1 - SanFrancisco Accounts Receivable/Accounts Payable 1.4 
* 5648SF1 - SanFrancisco Base 1.4 


° 5648WM1 


- SanFrancisco Warehouse Mgmt 1.4 


* 5697F49 - MQSeries® Integrator for AS400 and DB2 V1.1 
¢ 5697G14 - DB2 Forms for iSeries Version 2 


© 5722AC2 - 


Cryptographic Access Provider 56-bit for AS/400 


* 5722CE2 - IBM iSeries Client Encryption (56-bit) 

* 5722551 Opt 32 - OS/400 - Directory Services 

* 5722WDS Opt 1 - AS/400 Tools - Build Tools 

* 5722WDS Opt 61 - Workstation Tools - WebFacing, CODE 
* 5722WDS Opt 62 - Workstation Tools - VisualAge® RPG 

* 5722WDS Opt 63 - Workstation Tools - WebSphere Studio 
* 5722WDS Opt 64 - Workstation Tools - VisualAge for Java 
° 5722XH1 - iSeries Access for Web (V5R1MO) 
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5733AS3 - WebSphere Application Server , Standard Edition for AS/400 (128 Bit) 
5733A47 - WebSphere Personalization Version 3.5 for AS/400 

5733B2B - Connect for iSeries 

5733PY2 - WebSphere Payment Manager for iSeries, V2.2 


5733WA3 - WebSphere Application Server Version 3.5, Advanced Edition for 
AS/400 (128 bit) 


5765D65 - IBM DB2 DataJoiner® Version 2.1.1 

5769DP3 - IBM DB2 DataPropagator’ for AS/400 Version 7.1 
5769SA3 - OS/400 Integration for Novell NetWare 

5769XZ1 - OS/2 Warpserver for AS/400 

5769AC1 - Cryptographic Access Provider 40-bit 

5697ADS - Tivoli® ADSTAR Distributed Storage Management 
5769AS1 - WebSphere Application Server for AS/400 

5769CB1 - ILE Cobol 

5769CE1 - AS/400 Client Encryption 

5769CF1 - IBM Point-of-Sale Communications Utility for AS/400 


5769CL3 - IBM VisualAge RPG and Cooperative Development Environment for 
AS/400 


5769CX2 - IBM Integrated Language Environment® C for AS/400 
5769CX5 - IBM VisualAge for C++ for AS/400 

5733DME - Domino Migration Engine for iSeries 

5769FW1 - IBM Firewall for AS/400 

TivolTD - Tivoli IT Director 

5769MQ2 - IBM MOSeries for AS/400 

5798NC3 - IBM Net.Commerce’™ for AS/400, Version 3.1 

5769PM1 - IBM Performance Management/400 

5769PW1- IBM Application Development ToolSet for AS/400 
5733PY1 - IBM Payment Server’” for AS/400, Version 1.2 

5769RD1 - Option 6, OnDemand Client for Windows 3.1 

5769RD1- Option 7, OnDemand Client for OS/2 

5769RD1- Option 8, OnDemand Client for 32 bit Windows 
5769RG1- IBM Integrated Language Environment® RPG for AS/400 
5769SA2 - IBM Integration Services for FSIOP 

5769SS1 - Option 15, OS/400 - Common Programming APIs Toolkit 
5769SS1 - Option 17, OS/400 - PSF/400 Fax Support 

1TDSVR - Tivoli IT Director 

5798TBG - NetView® FTP 

5798TBW - IBM Wireless Connection for AS/400 

5798TBY - Facsimile Support for AS/400 

5798WC4. - WebSphere Commerce Suite, Pro Edition, Version 4.1 
5798WC5 - WebSphere Commerce Suite, Pro Edition for iSeries, Version 5.1 
5639VW5 - Visual Warehouse’ 5.2 

5769WP1 - OfficeVision for AS/400 

5763XD1 - Client Access” for Windows 95/NT 

5763XK1 - Client Access Enhanced for Windows 3.1 
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* 5649xxx - All Model 150 products 


Once you install V5R1MO or any later release, these products will no longer work. 
You cannot use Restore License Programs (RSTLICPGM) to load a previous release 
of these products onto a server with V5R1M0O or later version of the operating 
system. To avoid losing data that depends on these products, migrate that data 
from your server to an accessible location before upgrading to V5R1MO or any 
later release. 


* For assistance in migrating your data to AS/400 Netserver, see the redbook The 
AS/400 NetServer Advantage, SG24-5196. 


* For additional information, read the redpaper: Migration Options for OS/2 Warp 
Server for AS/400 and OS/400 Integration for Novell NetWare, REDP0020. 


* For alternative ideas to help migrate your data, see information APAR 1111689. 
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Chapter 16. System Synchronization-Planning and Procedures 


System synchronization is the second part of moving data between two systems. 
You perform system synchronization if you have purchased a new system, you 
have moved all of your data to the new system, and one of the following applies: 


* The existing system is a production system that needs to stay up and running 
while you convert to the new system. 


* You want to test the new system before making the switch over. 
Since the existing system is a production system, changes occur to the existing 
system which do not get applied to the new system. Therefore after you have 


loaded the new system, you need to synchronize the new system and the existing 
system before you can put the new system into production. 


You can perform system synchronization only if one the following is true: 


* The new system and the existing system are at the same release. You have full 
reloaded the new system from the existing system either using 


entire system after a complete system loss—Checklist 20” on page 98 


* The new system is at a newer release than the existing system. You have fully 
reloaded the new system from the source system using one of the procedures in 
The method that you use to synchronize the two systems is the side-by-side 
method. The underlying principal of the side-by-side method is that you will run 
your existing system and your new system in parallel for a test period. During that 
test period, you will periodically perform activities to synchronize the data on your 
new system with the data on your existing system. At the end of the test period, 
you will perform final synchronization activities before moving your production 


work to your new system. When you complete your final synchronization, the 
software environment on the two systems should be identical. 


The topics that follow discuss several different approaches that you can take for 
performing synchronization. In all cases, synchronization requires careful planning 
and monitoring. It also requires a good understanding of your applications and the 
library structure on your system. Running two systems in parallel also requires 
strong change-control practices. This chapter focuses primarily on synchronizing 
data. 


If possible, during the synchronization period you should carefully limit other 
changes on your existing system, such as adding or changing user profiles or 
changing the system distribution directory. When this type of change to system 
customization occurs on your existing system, you need to manually perform the 
same updates on your new system. 


You might find the security auditing function helpful for keeping track of changes 
to system information on your existing system. If you are not familiar with 
security auditing see the iSeries Security Reference book. It describes how to set up 
security auditing and which values to choose to get the entries that you need. 
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You can print the entries in the audit journal receiver and enter the same 
information on your new system. The Security ToolKit provides a function to 
select, format, and print (or display) audit journal entries. 


Existing System New System 


Set up journaling 


Restricted state 
Point 1 Save all user data 
> 


Activity occurs Point 1 Build target system 
> 


Restricted state 


Point 2 Capture changes Activity occurs 
> 


Preserve changes 


Activity occurs 


Point 2 ‘ Apply changes 


Restricted state 
Point 3 a‘ Capture changes Activity occurs 


Preserve changes 


Point 3 . Apply changes 


RBANS504-0 


Figure 30. Overview of Synchronization Process 


[Figure 30|provides an overview of the synchronization process. The process starts 
with building an initial test environment that matches a known point on your 
existing system (Point 1). Periodically, you establish a new known point 
(synchronization point) on your existing system. Point 2 and Point 3 are examples 
of synchronization points. After preserving any work that you have performed on 
your new system, such as object conversion, you use one of the synchronization 
methods to bring your new system to the same level as your existing system. 


While you read and plan, consider how the options for synchronization relate to 
your current procedures (such as regular save procedures and change control 
procedures). By using your existing procedures as a starting point, you can reduce 
the level of disruption and build on your existing base of knowledge. For example, 
if you currently use object journaling, then object journaling might be a logical part 
of your synchronization strategy. If no one in your organization has experience 
with object journaling, then it might not be the best solution for you. 


;_ Start with a Valid Test Environment 
All of the following synchronization methods assume that you start by 
loading an entire copy of your existing system to your new system. To create 
this initial test environment, you must follow the sequence in your reload 
checklist to ensure that the system correctly merges your user data with 


licensed program data. The reload checklist is 
if you are restoring to 
the same release or the procedures in 
if you are restoring to a higher release. 


Synchronization Methods: Overview 


Following are the common methods for synchronizing test and existing systems: 
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Moving changed objects 
With this method, you periodically save everything on your existing 
system that has changed since your last synchronization point. You then 
restore these changed objects to the new machine. 


Moving libraries 
With this method, you periodically copy entire libraries from your existing 
system to your new system. This method works best when your programs 
are in separate libraries from your database files. You synchronize the 
libraries that contain database files. 


Moving individual objects 
With this method, you periodically copy specific objects, such as database 
files, from your existing system to your new system. 


Applying journaled changes 
With this method, you journal objects on your existing system. You move 
the journal receivers from your existing system to your new system. You 
apply the journaled changes to the test objects on your new system. This 
method is sometimes used in conjunction with moving changed objects. 


Refreshing new system 
With this method, you periodically refresh your new system by restoring 
an entire copy of your existing system. 


‘Table 60} provides a comparison of these synchronization methods. It also shows 
where you can read more about each method. You can use these methods 
individually or in combination. 


Table 60. Comparison of Synchronization Methods 


Time Required for Frequency 
Method Complexity Risk Synchronization Used Where to Read More About It 
Moving changed High Medium | Medium High “Moving Changed Objects” 
objects to high 
Moving libraries Low Low to Medium Medium “Moving Entire Libraries” on 
medium to high 
Moving objects Medium | Low to Low to medium Medium “Moving Individual Objects” on 
to high medium page 362 
Applying journaled | High High Medium Low “Applying Journaled Changes” 
changes on page 363) 
Refreshing new Low Low High Low “Refreshing Your new system” 
system 
a The time required to apply journaled changed depends on how many journal entries need to be applied, 
and how many objects you need to apply those entries too. The greater these two numbers are, the longer 
synchronization time is. 


Moving Changed Objects 


With this method, you periodically save everything that has changed since your 
last synchronization point. You then restore those changed objects to your new 
system. The recommended method when you save changed objects is to specify an 
exact reference date and time that corresponds to your last synchronization point. 
This ensures that the contents of your save tapes are not affected by any 
intermediate save operations that might have occurred since your last 
synchronization point. 
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Following is an example of the save and restore procedures when you use this 
method. You will need to change these sample steps to meet the needs of your 
own situation. This example assumes that the last synchronization point was at 
1800 hours (6 p.m.) on July 27, 1998. 


Steps for Saving Changed Objects 


Perform these steps on your existing system: 


1. 


To avoid any problems with inadequate authority, sign on as the security 
officer (QSECOFR). 

Place your system in a restricted state to ensure that you get a stable copy of 
the changed objects on your existing system. 

Use the Save Security Data (GAVSECDTA) command to save all user profiles. 
You use this information to correctly synchronize ownership and authority for 
any new objects that you move. 


. To save objects that have changed since your last synchronization point, use 


the Save Changed Object (GSAVCHGOBJ) command. This command example 
saves objects in libraries (the QSYS.LIB file system): 
SAVCHGOBJ OBJ(*ALL) LIB(*ALLUSR) DEV(tape-device) 


OBJJRN(*YES) REFDATE('07/27/xx') REFTIME(180000) 
ACCPTH(*YES) 


Note: If you are using the SAVCHGOBJ method in conjunction with applying 
journaled changes, specify OBJJRN(*NO). 


If you have user libraries whose names begin with Q, save the changed 
objects in those libraries. Repeat step|4| and substitute the name of your Q 
library in place of *ALLUSR. 


Note: The online information for the LIB parameter tells which Q libraries are 
included when you specify *ALLUSR. 

To save document library objects that have changed since your last 

synchronization point, use the Save Document Library Object (GAVDLO) 

command: 


SAVDLO DLO(*SEARCH) DEV(tape-device) 
REFCHGDATE('07/27/xx') REFCHGTIME (180000) 
SRCHTYPE(*ALL) OWNER(*ALL) 


You cannot just save changed mail. You must save all mail, if necessary. To 
save mail, use the Save Document Library Object (GSAVDLO) command as 
follows: 

SAVDLO DLO(*MAIL) 

To save objects in directories that have changed since your last 
synchronization point, do the following: 


Note: *LANSERVER and *NETWARE are not supported on V4R5M0 or 
later. 


a. If you have any network server descriptions (NWSDs), you must vary 
them off before starting the save procedure. Use the command 
WRKCFGSTS CFGTYPE(*NWS) (Work with Configuration Status) to 
display the configured NWSDs on your system. 


Select option 2 (Vary off) on this display to vary off the NWSDs. 


Note: Alternatively, use the Vary Configuration command to vary off a 
NWSD: 


VRYCFG CFGOBJ(XXX) CFGTYPE(*NWS) STATUS (*OFF) 
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9 


10. 


11. 


12. 


Steps fo 


(— Test Objects to Preserve 


b. Use the Save (SAV) command to save changed objects: 


SAV DEV('/QSYS.LIB/tape-device.DEVD') 
OBJ(('/*' *INCLUDE) ('/QSYS.LIB' *OMIT) 
('/QDLS' *OMIT)) CHGPERIOD('07/27/xx' 180000) 
UPDHST (*YES) 
. To vary on the network servers, use the WRKNWSSTS command and select 
option 14. Use the WRKCFGSTS *NWS command to display all network 
servers and select option 1 to vary on any that were previously varied off. 


Use the Start Subsystem (STRSBS) command to restart the controlling 
subsystem to return your system to productive use. 


To display the log of what changed objects the system saved, use the Display 
Job Log (DSPJOBLOG) command. 


Print the job log and highlight each library that was saved. You will need this 
information to restore changed objects. 


r Restoring Changed Objects 


This example assumes that you are not making permanent changes to volatile 
objects (such as database files) on your new system. When you restore, you 
will be overlaying test objects. 


It also assumes that after you build your initial new system, you will not 
restore programs from the existing system to the new system during 
synchronization (because those programs are already converted on your new 
system). 


If you need to preserve test objects or if programs change on your existing 
system, you need to make special plans for your restore procedures. 


To 


restore the changed objects that you saved, perform these steps on your test 


system: 


“ 


For more information about restoring changed objects, refer to 
en You Restore Objects” on page 44 


A: 


To avoid any problems with inadequate authority, sign on as the security 
officer (QSECOFR). 


Place your system in a restricted state. 
To restore the saved user profiles, use the Restore User Profile (RSTUSRPRF) 
command: 


RSTUSRPRF USRPRF(*ALL) DEV(tape-device) 

ENDOPT (*LEAVE) 
If your new release is V4R3MO or a newer release, you can omit this step. If 
your test machine has a different serial number, use the Change User Profile 
(CHGUSRPRF) command to add *ALLOBJ special authority to user profiles, if 
necessary. 


Locate the printout of the job log from your save operation. Use it to 
determine which libraries the system saved. If you do not have the job log, 
you can use the Display Tape (DSPTAP) command to display the contents of 
the save tapes: 

DSPTAP DATA(*SAVRST) OUTPUT (*PRINT) 


For each library on the save tapes, type the following: 
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RSTOBJ OBJ(*ALL) DEV(tape-device) OBJTYPE(*ALL) 
SAVLIB(library-name) ENDOPT(*LEAVE) MBROPT(*ALL) 


Notes: 

a. For both the QGPL library and the QUSRSYS library, you must specify 
MBROPT(*NEW). This prevents overlaying new system files with old system 
files. 

b. Do not specify ALWOBJDIF(*ALL). Normal restore processing with the 
default ALWOBJDIF value protects you from accidentally overlaying 
critical information. ALWOBJDIF(*ALL) is intended only when you are 
initially loading information from one system to another. 

c. If your new system has a different ASP configuration from your existing 
system, you might need to specify the SAVASP and RSTASP parameters. 

7. To restore document library objects that you saved in step|6 on page 356} type 
the following: 

RSTDLO DLO(*ALL) DEV(tape-device) ENDOPT(*LEAVE) 


Notes: 

a. Do not use this restore command unless your save tapes contain only 
changed DLOs. If you restore all DLOs from your existing system, you 
will overlay IBM-supplied objects that are used for iSeries Access. 

b. This command does not restore mail that has changed. Mail gets restored 
in step 

c. Changes to calendars are restored when you restore the QUSRSYS library. 

d. If you have DLOs in more than one ASP, you need to run the RSTDLO 
command for each ASP. You specify the SAVASP and RSTASP parameters. 

8. To restore mail that you saved in step|7 on page 356] use the Restore 

Document Library Object (RSTDLO) command as follows: 

RSTDLO DLO(*MAIL) 
9. To restore the changed directory objects that you saved in|8b on page 357} type 
the following: 

RST DEV('/QSYS.LIB/tape-device.DEVD') 

OBJ(('/*' *INCLUDE) ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT)) 
10. Use the Display Job Log to print your job log: 
DSPJOBLOG OUTPUT (*PRINT) 


Review it carefully. Whenever you restore changed objects, you are likely to 
encounter situations that you will need to recover manually. If you plan to 
synchronize your system several times, you might find it useful to create a log 
that describes synchronization problems and their resolutions. This will help 
to reduce your synchronization time in the future. 


“Problems When Restoring Changed Objects” on page 359} describes common 


problems and solutions when restoring changed objects. 


11. After you resolve any problems that occurred with restored objects, use the 
Restore Authority (RSTAUT) command to restore private authorities. 


Note: You should wait to restore authority until after you resolve any 
problems because some problem resolution steps might require you to 
restore new objects. 

12. Restart the controlling subsystem and make the system available for more 
testing. 
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Problems When Restoring Changed Objects 


Because you specify ALWOBJDIF(*NONE) when you restore changed objects, the 
system compares heading information on the system copy of an object with 
heading information on the media copy. When the system detects discrepancies 
that might indicate mismatches, the system does not restore an object. Following 
are common cases where this occurs in a test environment and possible solutions: 


Problems Restoring Journal Receivers 

If you are journaling objects on both your existing system and your new system, 
you might have cases where two different journal receivers exist with the same 
name. Usually this occurs because you change journal receivers on both systems. 
The systems automatically generate the same next-receiver name. 


In some environments, you may not need the information that is in the journal 
receivers on your new system. Use the Change Journal (CHGJRN) command to 
create and attach a new journal receiver with a unique name. Then you can simply 
save and delete the journal receivers that you do not need (on your new system). 


Note: This strategy applies when you are using a change-object synchronization 
method. If you plan to apply journaled changes to synchronize systems, you 
need to devise a method for naming and changing journal receivers that 
allows you to successfully restore journal receivers. 


For more information about the rules to name, attach, and restore journal 
receivers, see the Journal Management topic in the iSeries Information 
Center at http: //www.ibm.com/eserver /iseries /infocenter. 


Problems Restoring Database File Members 

When you delete and re-create a database file, that database file has a different file 
level identifier than the previously saved version. Therefore, the file level identifier 
for the database file on your save media that you attempt to restore will not match 
the file level identifier on the new database file. When this type of mismatch 
occurs, the system will not restore the database file using the default values on the 
restore command parameters. The same problem occurs when you delete and 
re-create individual members for a database file, causing the member level 
identifiers of a file to mismatch. 


Following are several options for handling this problem. Choose the correct option 
for your situation. Base your decision on your synchronization requirements and 
your application architecture. Always make sure that you have a good backup of 
your new system. 


Recovery Option 1-Allow file level identifier differences on the restore operation: 
If you specify *FILELVL on the ALWOBJDIF parameter of the restore command, 
the file and/or member level identifier of a physical file can be different. If a 
database physical file already exists on the system with a different file and/or 
member level identifier than the saved physical file, then an attempt will be made 
to restore the physical file data. The file and/or member level identifiers of the 
physical file on the system remain unchanged. Objects other than physical files will 
be restored as if ALWOBJDIF(*NONE) is specified. 


Recovery Option 2-Restore entire library: A simple solution is to restore the entire 


library from your existing system to your new system. To do this, you will need to 
first clear the library on your new system. To use this option, you might need to 
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change your save strategy. For libraries where you regularly delete and re-create 
database files or members, you might not be able to use the SAVCHGOBJ 
approach. 


Recovery Option 3—Delete files or members before restoring: Another option is to 
delete (from the new system) the database file or the database file member that 
causes the problem. When you use this method, you must make provisions for any 
logical files that are dependent on the files or members that you plan to delete. Do 
the following: 


1. To determine whether dependent logical files exist, use the Display Database 
Relationships (DSPDBR) command on your test system: 


DSPDBR FILE(library-name/file-name) MBR(member-name) 


Note: Specify the member only when you need to delete individual members 
instead of the whole file. 


2. If no database dependencies exist, continue with step 


3. On your existing system, use the SAVOBJ command to save each dependent 
file to tape. 


4. On your test system, use the Delete File (DLTF) command to delete each 
dependent file. 


5. On your test system, delete the physical files or file members. 


6. From your SAVCHGOBJ tape, use the RSTOBJ command to restore the physical 
files or physical file members that you could not previously restore. 


7. If you saved dependent files in step 8] use the RSTOBJ command to restore 
them. 


Recovery Option 4-Use a temporary library: A variation of the previous option is 
to use a temporary library on your new system. Do the following: 
1. On the test system, use the Create Library (CRTLIB) to create a temporary 
library. 
2. Restore the physical files or file members from your SAVCHGOBJ tape to the 
temporary library. (Use the RSTOBJ command with the SAVLIB and RSTLIB 
parameters.) 


3. To determine whether dependent logical files exist, use the Display Database 
Relationships (DSPDBR) command on your test system: 


DSPDBR FILE(library-name/file-name) MBR(member-name) 


Note: Specify member only when you need to delete individual members 
instead of the whole file. 


4. If no database dependencies exist, continue with step 


5. On the test system, use the Copy File (CPYF) command to copy dependent 
files from the original libraries to the temporary library. 


Delete the dependent files from the original libraries. 
Delete the physical files from the original libraries. 
Copy the physical files from the temporary library to the original libraries. 


o ON 


If the temporary library contains any dependent files, copy them to the 
original libraries. 


10. Use the Delete Library (DLTLIB) command to delete the temporary library. 


Problems with Object Authority or Ownership 
To protect you from someone who might attempt to restore an illicit program to 
your system, the system makes authority or ownership changes during some 
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restore operations. Review the job log to determine whether these changes 
occurred. You can use the Change Object Owner (CHGOBJOWN) command to 
transfer ownership to the correct user profile. You can use the Edit Object 
Authority (EDTOBJAUT) command to make changes to public authority for an 
object. 


Moving Entire Libraries 


When your library structure is organized to separate volatile information (for 
example, database files) from static information (for example, programs), this 
synchronization method might be simple and effective. You can periodically restore 
entire database file libraries from your existing system to your new system. 


Note: Do not use this method for IBM-supplied (Qxxx) libraries, particularly the 
QGPL library and the QUSRSYS library. 


Following is an example of the steps for moving a library: 

1. On your existing system, sign on with the QSECOFR user profile to avoid 
authority problems. 

2. Place your existing system in a restricted state to ensure that you get a fixed 
(static) copy of the database files. 

3. Use the SAVSECDTA command to save all user profiles. You use this 
information to correctly synchronize ownership and authority for any new 
objects that you move. 

4. Use the Save Library (SAVLIB) command to save the libraries to tape: 
SAVLIB LIB(library-name) DEV(tape-device) 

ENDOPT(*LEAVE) ACCPTH(*YES) 
Notes: 
a. Specify ENDOPT(*REWIND) when you save the last library. 
b. You can specify multiple libraries on the SAVLIB command. 

5. Restart the controlling subsystem on your existing system. 

6. On your test system, sign on with the QSECOFR user profile to avoid 
authority problems. 

7. Place your new system in a restricted state to ensure that you do not have 
restore problems because of object-locking conflicts. 


8. Use the Clear Library (CLRLIB) for each library that you plan to restore. This 
eliminates any potential problems with objects not restoring because of 
mismatches between the media version and the system version. 


Note: If you restore a library that contains Structured Query Language (SQL) 
collections that contain *DTADCT objects, for each of these libraries use 
the Delete Library (DLTLIB) command. (Use DLTLIB rather than Clear 
Library (CLRLIB). SQL collections that contain *DTADCT objects will 
fail during the Restore Library (RSTLIB) operation unless you first 
delete the library. 

9. To restore the saved user profiles, use the RSTUSRPRF command: 

RSTUSRPRF USRPRF(*ALL) DEV(tape-device) ENDOPT(*LEAVE) 

10. If your new release is V4R3MO0 or a newer release, you can omit this step. If 
your test machine has a different serial number, use the Change User Profile 
(CHGUSRPRF) command to add *ALLOBJ special authority to user profiles, if 
necessary. 


11. For each library that you saved, use the Restore Library (RSTLIB) command: 
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RSTLIB SAVLIB(library-name) DEV(tape-device) MBROPT(*NEW) 
ENDOPT(*LEAVE) OPTION(*NEW) ALWOBJDIF(*ALL) 


Notes: 


a. If you have a different ASP organization on your new system, you might 
need to specify the SAVASP and RSTASP parameters. 


b. You specify ALWOBJDIF(*ALL) because you may be restoring to a system 
with a different serial number. ALWOBJDIF(*ALL) links the authorization 
lists back with the objects. You should only specify ALWOBJDIF(*ALL) 
when you are restoring to an empty library or the library does not exist on 
the system. 


c. When you restore the last library, specify ENDOPT(*REWIND) unless you have 
additional objects to restore from the tape. 


12. Check your job log to ensure that the system successfully restored the 
libraries. 


13. Use the RSTAUT command to restore private authorities to objects. 


Considerations for Moving Entire Libraries 
Following are some considerations when you use this synchronization method: 


* You might want to combine this method with the SAVCHGOBJ method. For 
example, you might move several large libraries that contain database files. You 
can use the SAVCHGOBJ command for other libraries (by using the OMITLIB 
parameter on the SAVCHGOBJ command to omit libraries that you are moving 
in their entirety). SQL collections containing *DTADCT objects will fail during 
the Restore Library (RSTLIB) operation unless you first delete the library. 


* When you use this method, you need to decide how to handles DLOs and 
objects in directories. You might use a save-changed method for those objects. 
Or, you might consider moving entire folders or directories if that method will 
work with your folder and directory organization. 

* In all cases, it is essential that you have a complete copy of your existing system 
on tape before you cut over to your new system. This provides for recovery if 
you discover you have neglected to synchronize some critical objects. 


Moving Individual Objects 


With this method, you periodically copy specific objects (or example, database 

files) from your existing system to your new system. This method is most often 

used in two situations: 

* When you have a short test period, careful change control, and a very 
well-defined set of database files that change frequently. 

* When you plan to completely rebuild your new system at the end of the test 
period. In this case, you might periodically move individual objects to create a 
more current set of test data on your new system. 


Following is an example of the procedure for moving individual objects: 


1. On your existing system, sign on with the QSECOFR user profile to avoid 
authority problems. 

2. Place your existing system in a restricted state to ensure that you get a fixed 
(static) copy of the database files. 


3. Use the SAVSECDTA command to save all user profiles. You use this 
information to correctly synchronize ownership and authority for any new 
objects that you move. 
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4. Use the SAVOBJ command to save individual objects that you want to 
synchronize: 


SAVOBJ OBJ (object-name) 
LIB(library-name) 
OBJTYPE (object-type) 
DEV(tape-device) ENDOPT(*LEAVE) 
Notes: 
a. Specify ENDOPT(*REWIND) for the last object. 


b. On the same SAVOBJ command, you can save multiple objects of the same 
type from the same library. 


5. Restart the controlling subsystem on your existing system. 


> 


Place your new system in a restricted state. 
7. On the new system, use the RSTUSRPRF command: 


RSTUSRPRF USRPRF(*ALL) DEV(tape-device) 
ENDOPT (*LEAVE) 


8. If your new release is V4R3MO or a newer release, you can omit this step. If 
your test machine has a different serial number, use the Change User Profile 
(CHGUSRPRF) command to add *ALLOBJ special authority to user profiles, if 
necessary. 


9. For each library that contains objects that you saved, use the RSTOBJ 
command: 


RSTOBJ OBJ(*ALL) SAVLIB(library-name) 
DEV(tape-device) ENDOPT(*LEAVE) OBUTYPE(*ALL) 


Notes: 


a. If you have a different ASP organization on your new system, you might 
need to specify the SAVASP and RSTASP parameters. 


b. When you restore the last object, specify ENDOPT(*REWIND). 
10. Check your job log to ensure that the system successfully restored the objects. 
11. Use the RSTAUT command to restore private authorities to objects. 
12. Restart the controlling subsystem on your new system. 


Applying Journaled Changes 


With this synchronization method, you use server journaling capabilities to 
synchronize the information in journaled objects on your test and existing systems. 
This is most commonly used either by installations that already use and 
understand journaling or by installations that have very large journaled objects. 


The advantage of this method is that you save and restore only the changes that 
occur to a journaled object, not the entire object. The disadvantage of this method 
is its complexity. See the Journal Management topic in the iSeries Information 
Center at http://www.ibm.com/eserver/iseries/infocenter for more information 
about journaling. 
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; Journal Before Saving 
You must set up journaling on your existing system before you perform the 
save operation from which you build your new systems. When you start 
journaling for an object, the system assigns a journal ID number (JID) to that 
object. An object must have a JID before you save it from your existing 
system and restore it to your new system or you will not be able to apply 
journaled changes to the test version. For more information about restoring 


journaled objects see |“Restoring Objects That Are Journaled” on page 243 


Conceptually, when you use journaling to synchronize objects, you do the 
following to establish a synchronization point: 


1. On your existing system, do the following: 


a. 


Cc. 


Save security data to get a current copy of user profiles and private 
authorities. 


Save new journal receivers (that contain entries that you have not yet 
applied on your new system). 


Save any new objects (that do not yet exist on your new system). 


2. On your new system, do the following: 


a. 


paog> 


Restore user profiles (to get any new profiles and current authority 
information). 


Restore any new objects. 

Restore journal receivers. 

Apply journaled changes from the journal receivers. 
Restore authority to any new objects. 


Following is an example of the steps for using journaled changes to synchronize 
systems: 


1. To establish a checkpoint on your existing system, do the following: 


a. 


Use the Work with Journal Attributes (WRKJRNA) command to determine 
what journal receivers have been created since your last checkpoint. 


b. Write down the names of the new journal receivers. 


. Determine whether any members, files, or data areas have been added to 


any journaled objects since your last checkpoint. You can use the DSPJRN 
command to do this by typing the following: 


DSPJRN JRN(journal-name) JRNCDE((D) (F) (E)) ENTTYP(JF JM EG) 
RCVRNG(first-receiver *CURRENT) 


For first-receiver, use the name of the first receiver after the most recent 
checkpoint. 


Note: If you are journaling IFS objects, and your directories are not using 
the inherit journaling attribute, look for new IFS objects by adding B 
to the JRNCDE parameter, and JT to the ENTTYP parameter. 


d. Write the new object names on a list. (You will need to save them later.) 
e. If you have other journals on your system, repeat step [1althrough step[l¢| 


for each additional journal. 


For each journal on your system, use the CHGJRN command to detach the 
current journal receivers and attach new journal receivers. 
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Use the SAVOBJ command or SAV command to save any newly journaled 
objects that you listed in step [id]and step |1c} If the new objects are new file 
members, be sure to save only the new members, not the entire files. 


Note: The system needs an exclusive lock on an object to save it. You might 
need to stop certain application activity on your system to be able to 
save the newly journaled objects. 


Use the SAVOB] command to save the journal receivers that you listed in 
step |1b on page 364 


If you do not have a current copy of your user profiles on tape, use the 
SAVSECDTA command to save them to tape. 

You have completed establishing a new checkpoint (such as Point 2) on your 
existing system. 


2. To synchronize the journaled objects on your new system with the existing 
versions, do the following: 


a. 
b. 


g. 


h. 


Place your new system in a restricted state. 
On the new system, use the RSTUSRPRF command: 


RSTUSRPRF USRPRF(*ALL) DEV(tape-device) 
ENDOPT (*LEAVE) 


. If your new release is V4R3MO or a newer release, you can omit this step. If 


your test machine has a different serial number, use the Change User Profile 
(CHGUSRPRF) command to add *ALLOBJ special authority to user profiles, 
if necessary. 

Use the RSTOBJ or RST command to restore any objects that you saved in 


step 


. Use the RSTOBJ command to restore the journal receivers that you saved in 


step 
Use the Apply Journaled Changes (APYJRNCHG) command to bring your 
journaled objects to the checkpoint level: 


* For the starting receiver, specify the journal receiver that was created and 
attached when you established your most recent checkpoint on the 
existing system. For the ending receiver, specify *CURRENT. 


* For the starting sequence number, specify *FIRST. 
* For the ending sequence number, specify *LAST. 


See the Journal Management topic in the iSeries Information Center at 

http: //www.ibm.com/eserver /iseries/infocenter to understand what journal 
entries may either be skipped or may stop the apply process. 

Use the RSTAUT command to restore private authorities for any new 
objects that you restored. 


Restart the controlling subsystem on your new system. 


Refreshing Your new system 


When you use this method, you periodically rebuild your entire new system from 
the current information on your existing system. To ensure that user data and 
system data are merged correctly, you must follow the same procedure that you 
used when you initially built your new system: 

1. Install the Licensed Internal Code from scratch. 

2. Install OS/400. 


3. Restore user data. 
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4. Install licensed programs. 


Note: The preceding list is a conceptual view of the sequence. Use the checklists 
for the complete list of steps. 


Before refreshing your new system, be sure to save the work that you have already 
performed on your new system. In particular, save any program objects that you 
have converted. After you have rebuilt the new system, restore these converted 
objects. 


Additional Synchronization Tips 


Following are some additional considerations when you plan to keep your test and 
existing systems synchronized during a test period: 


* Synchronization (especially the first few times) can be difficult. You should 
always save your entire new system before you begin your synchronization 
efforts. With these save tapes available, you have the option of restoring your 
entire new system and starting the synchronization again (or changing 
synchronization methods). 


* To synchronize correctly, you need to understand how to save and restore the 
authority to objects. When you use the SAVSECDTA command, the system saves 
user profiles, authorization lists, and private authorities. 


When you restore user profiles (RSTUSRPRF *ALL), the system restores user 
profiles and authorization lists. It puts private authority information in work 
files on the system. After you restore objects, use the RSTAUT command to 
re-establish the private authorities that are in the work files. 


* When you are ready to perform your final synchronization before you move 
your new system to productive use, be sure to plan both for disaster recovery 
and for verification. If possible, keep your former existing system functional 
during the verification period in case you discover objects that you did not 
properly synchronize. 

In addition, make sure that you save an entire copy of your former existing 
system to tape before you dismantle it. You might need the objects on these 
tapes if you discover errors in your synchronization procedures. 

Finally, print listings from your former existing system that you can use as a 
basis for verifying the validity of information on your new existing system. 

* Good synchronization requires careful change-control procedures. You must plan 
for information that you cannot easily synchronize automatically, such as 
changes to system information. As much as possible, you should freeze changes 
to this type of information during your test period. 

* If you do not use the SAVCHGOBJ command as part of your synchronization 
strategy, you might need to use special procedures to synchronize calendars and 
mail. 

Following are the steps for moving calendars from your existing system to your 
new system: 
1. On your existing system, use the Save Calendar (SAVCAL) command: 


SAVCAL CAL(*ALL *ALL) DEV(tape-device) 
DATE('07/27/xx' *END) 


Note: Option 34 from the Save menu runs the same command. 
2. On your new system, use the Restore Calendar (RSTCAL) command: 


RSTCAL CAL(*ALL *ALL) DEV(tape-device) 
SAVLIB(QTEMP) LABEL(QCAL*ALL*ALL) 
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Note: Option 33 from the Restore menu runs the same command. 


Following are the steps for moving mail from your existing system to your new 
system: 


1. 


On your existing system, use the SAVDLO command: 
SAVDLO DLO(*MAIL) DEV(tape-device) 

On your new system, use the RSTDLO command: 
RSTDLO DLO(*MAIL) DEV(tape-device) 


* To synchronize the BRMS licensed program, do the following: 


Note: Use the following tip only for BRMS installations that do not share media 


1. 


information with other systems. 


On your existing system, stop all activity that might place locks on objects in 
the BRMS libraries. If you have scheduled jobs that use BRMS, you need to 
hold them. 


Mount a tape that is compatible with the tape unit on your new system. 
Type the following: 
SAVLIB LIB(QBRM QUSRBRM) DEV(tape-device) 


Note: If you want, you can use save files and transfer the libraries 
electronically. 


On the new system, do the following: 


a. Stop all activity that might place locks on objects in the BRMS libraries. If 
you have scheduled jobs that use BRMS, you need to hold them. 


b. Save a copy of the current BRMS product; enter the following command: 
SAVLICPGM LICPGM(57nnBR1) DEV(tape-device) 
(Replace nn with the appropriate number for your release, 
for example, DSPPTF 5763BR1 for V3R2.) 


c. Delete the version of BRMS that has outdated information; enter the 
following command: 


DLTLICPGM LICPGM(57nnBR1) 
Mount the tape that you created in step 
Restore the BRMS libraries; enter the following command: 
RSTLIB SAVLIB(QBRM QUSRBRM) DEV(tape-device) 
f. Load the tape that you created using SAVLICPGM in step [4b] 
g. Restore the current version of BRMS; enter the following command: 
RSTLICPGM LICPGM(57nnBR1) DEV(tape-device) 


h. To set up BRMS again, consult Backup Recovery and Media Services for 
iSeries. 
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Part 5. Considerations for Merging Two or More Systems 
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Chapter 17. Tips for Merging Two RISC Systems Into a Single 


RISC System 


Merging systems is a complex process. Various factors can affect merging systems 
that include the software release, system names, or IBM-supplied objects. The 
following information is provided as a guideline to assist you in the planning 
process of merging systems. You should consult the documentation for your 
additional products to ensure proper migration. 


Objects that can migrate from one system only are: 


Directory entries 

Office enrollments 

Distribution lists 

Other IBM-supplied files or libraries 
System values 

Network attributes 

Access path recovery times 
Communications configurations 
System reply list 

Edit descriptions 


Determine which system to restore all of these objects from and restore that system 
first. If you have a production system and a development system, restore the 
production system first, then follow the guidelines below to restore the information 
from the development system. 


Guidelines for Restoring Information from the Development System 


1. 


Determine which system to restore first. To assist in determining this, you may 
need to answer several questions: Which system is more complex? Which has 
more users? Which system is more critical to your operations? If you are 
choosing between merging a production system and merging a development 
system, selecting the production system is recommended. 


Restore the production system by following the steps in|Table 27 on page 99 


User profiles and associated objects that are the same on both systems will not 

be merged. However, they are affected in the following manner: 

* Object owners, authorization lists, and primary groups will be restored from 
the production system. 

* Passwords and group connections will be restored from the development 
system. 

* Merging of private authorities is an AND operation. The object authorities 
and data authorities will be added together from both systems. The resulting 
authorities on the merged system will be the higher of the matching 
authorities from the production and development systems. 


* USRPRF (*NEW) and OMITUSRPRF are parameters that may be useful when 


you consolidate systems. They allow_you to restore only new user profiles or 
omit certain user profiles. Refer to |“Restoring User Profiles” on page 222|for 


more information. 
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3. Groups of configurations that are needed from the development system may be 
restored with the Restore Configuration (RSTCFG) command: 


RSTCFG OBJ(workstation) OBJTYPE(*DEVD) 
SRM(*NONE) 


Automatic configuration may also be enabled to recover the groups of 
configurations from the development system. 


4. User libraries may be restored with the Restore Library (RSTLIB) command. 


Note: Be sure to omit any IBM-supplied libraries such as QGPL and QUSRSYS. 
If there are libraries that are the same on both systems, you should consider 
using the OPTION(*NEW) parameter to restore only the new objects: 


RSTLIB SAVLIB(User library) OPTION(*NEW) 


Then determine which objects you want from each system and restore those 
objects individually. If there are objects in QGPL or QUSRSYS that are unique 
to either system, those objects should be restored individually as well. 


5. Documents and folders may be restored with the RSTDLO command. When 
saving documents and folders to be restored, any IBM-supplied folders should 
be omitted when using the SAVDLO command: 


SAVDLO DLO(*ALL) OMITFLR(Q*) 


If any IBM-supplied folders are restored, the original information may be 
overwritten. Additional considerations will need to be made if any of the DLOs 
are from a previous release. 


6. The Integrated File System (IFS) may be restored with the following command: 
RST OPTION (*NEW) 


7. Once the preceding instructions have been completed, run the Restore 
Authorities (RSTAUT) command. 


8. Once the RSTAUT command completes, perform a normal IPL. 
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Part 6. Alternate Installation Device 
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| Chapter 18. Using an Alternate Installation Device 


Alternate Installation Device—Overview 


You can perform installation and recovery procedures by using a combination of 
devices. In earlier releases, these types of activities could be performed only by 
using devices that were attached to the first system bus. (The first system bus 
connects to the service processor IOP. Typically this is where the optical device or 
tape device that is used for an installation is attached.) Now, you can use a 
combination of devices that are attached on the first system bus and on additional 
buses. 


If you use this function, the system uses existing support (a device on the first 
system bus) to install or recover a portion of the Licensed Internal Code. This 
allows you to perform an IPL-type D. With the alternate installation device 
support, the system continues the operation by using media in the alternate 
installation device. This function supports installation and recovery from tape 
media, such as SAVSYS or distribution tapes which you created, that contain 
Licensed Internal Code and may contain the operating system, licensed programs, 
and data. 


Some models, typically with 3590 tape devices attached, may see a performance 
improvement when using an alternate installation device for save operations. 


Installation and Recovery Implications 


You can use the alternate installation device function for any installation or 
recovery that requires replacing Licensed Internal Code. Some models may require 
that you set up an alternate installation device. After which, you use the alternate 
installation device to install the distribution media created by a central site or for 
recovering using a SAVSYS media volume. 


; Attention! 
Tape devices attached by a Fibre Channel interface will need to be set up as 
alternate installation devices. 


If you use an alternate installation device, you need to ensure that you set up the 
device and that you enable the device. You also need to have the CD-ROM for 
Licensed Internal Code and your save media. 


Setting up an Alternate Installation Device 


Before you use an alternate installation device, you need to ensure that you define 
it on a bus, and you must enable the device. You need to record and keep the 
logical address of the system bus and system card at which the alternate 
installation device is attached. If you have the device set up on different bus and 
you do not have this information available, you will not be able to complete 
installations or recoveries. 


If you change the configuration of your system, you need to ensure that this 
information is correct before you start to use the alternate installation device. 


© Copyright IBM Corp. 1997, 2002 375 


Do the following to set the addresses and enable the alternate installation device: 


Note: You need to know the password for Dedicated Service Tools to perform this 


_ 4. 


1. 


3. 


procedure. 
Place the optical media that contains the current release Licensed Internal 
Code into the optical device. 


Use the control panel to set the mode to Manual. Then perform an IPL 
using the command: PWRDWNSYS OPTION(*IMMED) RESTART(*YES) IPLSRC(B). 


Note: An alternative to this step is to use the control panel to select 
function 21. (Dedicated Service Tools). If you use this alternative, the 


next step is step|4] You will not need to perform step |12 on page 378 


;— Attention logical partitioning users! 
If you are going to use this command on the primary partition, be 
sure to power off all secondary partitions before running the 
command. 


When the IPL or Install the System display appears, select option 3 (Use 
Dedicated Service Tools (DST)) and press the Enter key. 


The Dedicated Service Tools (DST) Sign On display appears. 


Dedicated Service Tools (DST) Sign On 


System: SYSTEMA 


Type choices, press Enter. 


Sign on using the QSECOFR user profile. 


Note: Do not sign on with a profile other than QSECOFR. 


The Use Dedicated Service Tools (DST) menu appears. From the Use 

Dedicated Service Tools (DST) menu, do the following: 

a. Select option 5 (Work with DST environment). 

b. Select option 2 (System devices) on the Work with DST Environment 
display. 

c. Select option 5 (Alternate installation device) on the Work with System 
Devices display. 


From the Select Alternate Installation Device display, type a 5 (Display 
details) next to the resource you want and press the Enter key. 
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ie _ 


Select Alternate Installation Device 
System: SYSTEMA 


Additional devices may be available for use. Press F5 to see 
if any additional devices have been detected. 


Type option, press Enter. 
l=Select 5=Display details 


Bus Resource Serial 
Option Number Name Type Model Number Selected 
a 1 TAP08 6386 001 00-11111 
3 TAP19 3570 = B11 13-22222 * 


eevee eter device F3=Exit F5=Refresh F12=Cancel 


4 
7. The Display Device Details display appears. 
a 
Display Device Details ) 
System: SYSTEMA 
Resource Serial 
Name Type Model Number 
TAP19 3570 Bll 13-22222 
Physical location: 
EocattOni textes sec. ts ee 
Pirates 1 Do ae re caren eae at 
Gardisilot: @ saa Ge cee st 4p eer as 
Logical address: 
SPD bus: 
Systemibus’ 2 3 <2 <.%6 3 & 0003 
System board .......: 0000 
Systemscand  s. Gaucc 2 = i Sat 20002 
Storage: 
1/0 bus number ......: 0000 
Controller” js. se Fe sh 0007 
Device address ......: 0000 
F3=Exit F12=Cancel 
/ 


You need to have a record of the addresses assigned to the alternate 
installation device selected for installing and recovering your system. 
Record the following information: 


* Type/Model: 
* System bus: 
* System card: 


Notes: 


a. You may want to repeat this process to record the addresses for all 
alternate installation devices that appear in step You 
should store this information in a safe place, such as the location where 
your recovery information and recovery media are stored. 


b. If there more than one alternate installation device is defined, only one 
can be enabled. 


c. You should ensure that only one device contains valid installation 
media. This prevents you from loading the wrong version of the 
Licensed Internal Code. 
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__ 10. 
11. 


Press the Enter key. 


The Select Alternate Installation Device display appears. Type 1 (Select) 
next to the resource you want and press the Enter key. 


You should see the following message at the bottom of the display: 
Alternate installation device selected 
Press F3 (Exit) to return to the Use Dedicated Service Tools (DST) display. 


Press F3 (Exit) again. The Exit Dedicated Service Tools (DST) display 
appears. 


Exit Dedicated Service Tools 
System: SYSTEMA 


Select one of the following: 


1. Exit Dedicated Service Tools (DST) 
2. Resume Dedicated Service Tools 


_— 12. 


Type 1 (Exit Dedicated Service Tools (DST)) and press the Enter key. 

The next display display you see is the IPL or Install the System display. 
Type 1 (Perform an IPL) and press the Enter key to complete the 
procedure. 


Disabling an Alternate Installation Device 


You may need to disable an alternate installation device for one of the following 
reasons: 


* To continue with an installation using CD-ROM media. 


* To enable a different device as an alternate installation device. 


* To correct the logical address if hardware has been moved or changed. 


1. 


Use the control panel to set the mode to Manual. Then perform an attended 
IPL using the command: PWRDWNSYS OPTION(*IMMED) RESTART (*YES) 
IPLSRC(B). 


Note: An alternative to this step is to use the control panel to select function 
21. (Dedicated Service Tools). If you use this_alternative, the next step 


is step|3] You will not need to perform step|9 on page 379 


;— Attention logical partitioning users! 
If you are going to use this command on the primary partition, be sure 
to power off all secondary partitions before running the command. 


When the IPL or Install the System display appears, select option 3 (Use 
Dedicated Service Tools (DST)) and press the Enter key. 


The Dedicated Service Tools (DST) Sign On display appears. Sign on using 
the QSECOFR user profile. 


The Use Dedicated Service Tools (DST) menu appears. From the Use 
Dedicated Service Tools (DST) menu, do the following: 


a. Select option 5 (Work with DST environment). 

b. Select option 2 (System devices) on the Work with DST Environment 
display. 

c. Select option 5 (Alternate installation device) on the Work with System 
Devices display. 
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5. At the Select Alternate Installation Device display, press F2 (Deselect device). 

6. You should see the following message at the bottom of the display: 
Alternate installation device deselected 

7. Press F3 (Exit) to return to the Use Dedicated Service Tools (DST) display. 


8. Press F3 (Exit) again. The Exit Dedicated Service Tools (DST) display 
appears. Type 1 (Exit Dedicated Service Tools (DST)) and press the Enter 
key. 

9. The next display you see is the IPL or Install the System display. Type 1 
(Perform an IPL) and press the Enter key to complete the procedure. 


Verifying and Selecting an Alternate Installation Device during a 
Manual Installation 
__1. The Install Licensed Internal Code display appears. 


Install Licensed Internal Code 
System: — XXXX 
Select one of the following: 


1. Install Licensed Internal Code 
2. Work with Dedicated Service Tools (DST) 
3. Define alternate installation device 


Type 3, and press Enter. This will verify the address of an alternate 
installation device attached to the system and determine whether it is 
enabled or disabled. 


2. Verifying and Selecting Alternate Installation Device: The Select Alternate 
Installation Device Bus display appears. 


Select Alternate Installation Device Bus > 
System: XXXX 
Type Option, press Enter. 
1=Select 
Option Bus Number Selected 
1 

- 2 

1 3 * 

= 4 

= 5 

_ 6 

= 7 

- 8 

= 9 

a A 

= B 

S C 

o D 

More..... 
F2=Deselect Device F3=Exit F12=Cancel 
Se 7 


__a. Verify that the selected device is on the correct system bus. Type 1 in 
the Options field next to the selected bus, and press Enter to view 
information about the device that is attached to the bus. This may 
take several minutes. If you see the message No alternate 
installation device configured, wait one minute and refresh the 
screen. 


b. The Select Alternate Installation Device display appears. Use this 
display to verify the resource name, type, model, and serial number 
for the device. 
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e. 


(a - 


Select Alternate Installation Device 
System: SYSTEMA 


Additional devices may be available for use. Press F5 to see 
if any additional devices have been detected. 


Type option, press Enter. 
1=Select 5=Display details 


Bus Resource Serial 
Option Number Name Type Model Number Selected 
a i TAPO8 6386 =6001 00-11111 
3 TAP19 3570 = B11 13-22222 * 


F2=Deselect device F3=Exit F5=Refresh F12=Cancel 
SS Ly 


Type 1 to select the device and make any needed corrections to select, 
enable, or disable the device. Press Enter to confirm the changes. 


The message Alternate installation device selected appears. Press 
F3 to return to the Install Licensed Internal Code display. 


Type 1 and press Enter to install the Licensed Internal Code. 


End of Verifying and Selecting Alternate Installation Device. 
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Part 7. Disk Configuration and Protection — Procedures 


Chapter 19. Procedures for Configuring Disks 

and Disk Protection. 

Choosing the Right Procadute for Configuring 

Disks . 

Configuring Disks, ona New System—Checklist 1 
Adding Disk Units without Device Parity 
Protection—Checklist 2 

Adding Disk Units to an Existing Input/ Output 
Adapter—Checklist 3. 

Adding a New Input/Output Adapter—Checklist 
4 ; 

Moving Disk Units Benrees WoncWiiearea 

Auxiliary Storage Pools—Checklist 5 . 

Moving Disk Units Between Mirrored Auxiliary 

Storage Pools—Checklist 6 

Deleting an Auxiliary Storage Pool— Checklist 7 

Removing Disk Units Without Device Parity 

Protection—Checklist 8 

Removing Disk Units That Have Device Parity 

Protection from an ASP Without Mirrored 

Protection—Checklist 9 

Removing Disk Units That Have Device Parity 

Protection from an ASP With Mirrored 

Protection—Checklist 10 . 

Using System Service Tools and Dedicated 

Service Tools ‘ 

How to Start Dedicated Servite Tools (DST) 
How to Stop Dedicated Service Tools (DST) 
Starting System Service Tools (SST) . 
Stopping System Service Tools (SST). 

How to Display Your Disk Configuration . 
Displaying Your Disk 
Configuration—Hardware View 
Displaying Your Disk 
Configuration-Software View . 

Interpreting Disk Configuration and Status 
Displays . eo Oe ee 


Chapter 20. Working with cas Storage 
Pools. : 
How to Add Disk nits. ii an ‘Atwdliary Storage 
Pool : ‘ 
How to Change fhe Storage Thieshold fein an 
Auxiliary Storage Pool 
How to Change the Storage Threshold fay ihe 
System Auxiliary Storage Pool. A 
How to Move a Disk Unit to a Different Awdliary 
Storage Pool. er : 
How to Remove a Disk Unit — an \ Auxiliary 
Storage Pool. 
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Storage Pool. 
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Chapter 19. Procedures for Configuring Disks and Disk 


Protection 


This chapter describes the procedures for using the character-based interface to 
configure and protect disks on your system. It includes checklists for performing 
the disk configuration tasks in the correct sequence. You can also configure disks 
through iSeries Navigator. For more information see Systems management —> 
Disk management —> Disk pools in the iSeries Information Center at 


http:/ /www.ibm.com/eserver /iseries /infocenter. 


You can use System Service Tools (SST) to do some disk configuration procedures 
while your system is active. For other procedures, you must stop your system and 
use Dedicated Service Tools (DST). This chapter provides information about both 


SST and DST. 


Choosing the Right Procedure for Configuring Disks 


This Sabie ter contains several checklists for performing configuration procedures. 


Use [Table 61|to determine which checklist to use for your situation. 


Table 61. Choosing the Right Disk Procedure 


Task Description 


Procedure to 
Follow 


Requires DST? 


Configure your system for the first time 


Checklist 1 on 
page 


Yes 


parity protection is started for some or all of the disks units that are attached 
to the IOA and they are in ASPs with mirrored protection. 


page 


Add one or more disk units that will not have device parity protection. This Checklist 2 on No 

checklist applies to disk units that are capable of device parity protection if page 

you do not plan to start device parity protection for the disks. 

Add one or more disks to an existing Input/Output Adapter. Use this Checklist 3 on No 

checklist if you plan to protect some or all of the new disks with device page 

parity protection. 

Add a new IOA. Use this checklist if you plan to protect some or all of the Checklist 4on page Yes 

new disks with device parity protection. [387] 

Move disk units between existing ASPs without mirrored protection. Checklist 5. on Yes 
page 

Move disk units between existing ASPs with mirrored protection. Checklist 6 on Yes 
page 

Delete a user ASP. Checklist 7 on Yes 
page 

Remove one or more disk units without device parity protection. Checklist 8 on Yes 
page 

Remove one or more disk units from an Input/Output Adapter (IOA). Use Checklist 9 on Yes 

this checklist if device parity protection is started for some or all of the disk page 

units that are attached to the IOA and they are in ASPs without mirrored 

protection. 

Remove one or more disk units from an IOA. Use this checklist if device Checklist 10 on Yes 
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Configuring Disks on a New System-Checklist 1 


This checklist shows the sequence of tasks that you use to configure disks on a 
new iSeries server. Whether you need to perform all the tasks depends on the disk 
protection that you want on your system. The topic Setting up disk protection for 
your data in the iSeries Information Center provides more information about the 
disk protection that is available. You can access the Information Center from the 
iSeries Information Center CD-ROM or from the following Web site: 


http://www. ibm.com/eserver/iseries/infocenter 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as 
you or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you diagnose any 
problems that occur. 


Attention: When you perform the tasks in this checklist, the system moves large 
amounts of data. Make sure that you have saved your system completely in the 
event that you need to recover from an error situation. 


Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 


Table 62. Configuring Disks on a New System-—Tasks 


Task What To Do Where To Read More About It 
___ Task 1 Start DST. “How to Start Dedicated Service Tools 
(DST)” on page 395 

___ Task 2 Display your disk configuration. Currently,  |“How to Display Your Disk Configuration” 
all of your disk units except the load source 
unit appear as nonconfigured. 

___ Task 3 If you plan to have device parity protection |“How to Start Device Parity Protection for an| 
on any of your disk units, start it using the Input/Output Adapter” on page 42 
procedure for the types of disk units that 
you have. 

__ Task 4 Add nonconfigured disk units to the correct |“How to Add Disk Units to an Auxiliar 
ASPs. Storage Pool” on page 403 

___ Task 5 The default storage threshold for each ASP is |“How to Change the Storage Threshold for 
90%. If you want a different storage an Auxiliary Storage Pool” on page 406 
threshold for any ASP, change it. 

___ Task 6 Specify the storage threshold for the system |“How to Change the Storage Threshold for 
ASP. If you use the QSTGLOWLMT and the System Auxiliary Storage Pool” on 
QSTGLOWACN system values, you can 
prevent the system ASP from filling to 
capacity and causing an abnormal shutdown. 

___ Task 7 If you plan to have mirrored protection for 


any ASPs, start it. 


“How to Start Mirrored Protection” on 
page 443 


___ Task 8 If you started mirrored protection, wait until |“Starting System Service Tools (SST)” on| 
the system completes the initial program page 396 
load. Then sign on and start SST. 

___ Task 9 Verify that your disk configuration is correct |“How_to Display Your Disk Configuration” 
and print a copy for your records. 

___ Task 10 End DST or SST. “How to Stop Dedicated Service Tools| 


DST)” on page 396] or |“Stopping 
Service Tools (SST)” on page 396 
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Adding Disk Units without Device Parity Protection—Checklist 


2 


This checklist shows the sequence of tasks that you use to add one or more disks 
to your system when you do not plan to protect the new disks with device parity 
protection. You can use either DST or SST to perform the tasks in this checklist. If 
you use SST, you can perform the tasks while your system is active. If you use 
DST, you must stop your system to perform the tasks in this checklist. 


, Adding to an ASP with Mirrored Protection? 
You can add disk units to an ASP that has mirrored protection without 
stopping and starting mirrored protection. You must add disk units in pairs 
with equal capacities. The added units will always be paired with each other. 
You may want to choose a later time, when your system can be unavailable 
for several hours, to stop and start mirrored protection. When you start 
mirrored protection again, the system evaluates the pairing for all disk units 
on your system. This may provide a higher level of availability for failures 
that affect a controller, an IOA, or a bus. 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as 
you or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you diagnose any 
problems that occur. 


Attention: When you perform the tasks in this checklist, the system moves large 
amounts of data. Make sure that you have saved your system completely in the 
event that you need to recover from an error situation. 


Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 


Table 63. Adding Disk Units without Device Parity Protection—Tasks 


Task What To Do Where To Read More About It 
__ Task 1 Physically attach disk units. This is normally 
done by a service representative. 
___ Task 2 Start DST or SST “How to Start Dedicated Service Tools 
DST)” on page 395[or|’ Starting System! 
Service Tools (SST)” on page 396 
___ Task 3 Print your current disk configuration. “How to Display Your Disk Configuration” 
___ Task 4 Add nonconfigured disk units to the correct |“How to Add Disk Units to an Auxiliar 
ASPs. See note 1 and note 2. Storage Pool” on page 403 
__ Task 5 If you created a new ASP on your system “How to Change the Storage Threshold for 
when you added disk units, the system set [an Auxiliary Storage Pool” on page 406 
the storage threshold of the ASP to 90%. If 
you want a different threshold, change it. 
___ Task 6 Specify the storage threshold for the system |“How to Change the Storage Threshold for 
ASP. If you use the QSTGLOWLMT and the System Auxiliary Storage Pool” on 
QSTGLOWACN system values, you can 
prevent the system ASP from filling to 
capacity and causing an abnormal shutdown. 
___ Task 7 Verify that your disk configuration is correct |“How to Display Your Disk Configuration” 


and print a copy for your records. lon page 397 
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Table 63. Adding Disk Units without Device Parity Protection—Tasks (continued) 


Task What To Do Where To Read More About It 
___ Task 8 End DST or SST. “How to Stop Dedicated Service Tools 


DST)” on page 396|or|“Stopping System| 
Service Tools (SST)” on page 396 


You can add the disk units to an existing ASP or you can add them to a new ASP. 


- If you are adding disk units to an ASP that has mirrored protectionand the new disk units do not have 


device parity protection, you must add pairs of disk units that have identical capacities. 


Adding Disk Units to an Existing Input/Output 
Adapter—Checklist 3 


This checklist shows the sequence of tasks that you use to add one or more disks 
to an existing input/output adapter. Use this checklist if you plan to protect some 
or all of the new disk units with device parity protection. If you do not plan to 
protect any of the new disk units, use checklist 2. 


You can use this procedure whether or not you have mirrored protection on your 
system because you start device parity protection protection before you add the 
disk units to an ASP. You can use either DST or SST to perform the tasks in this 
checklist. If you use SST, you can perform the tasks while your system is active. If 
you use DST, you must stop your system to perform the tasks in this checklist. 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as 
you or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you diagnose any 
problems that occur. 


Attention: When you perform the tasks in this checklist, the system moves large 
amounts of data. Make sure that you have saved your system completely in the 
event that you need to recover from an error situation. 


Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 


Table 64. Adding Disk Units to an Existing Input/Output Adapter—Tasks 


Task What To Do Where To Read More About It 


___ Task 1 Physically attach disk units. This is normally 
done by a service representative. 


___ Task 2 Start DST or SST “How to Start Dedicated Service Tools 


DST)’ on page 395 or| Starting System] 
Service Tools (SST)” on page 396 


___ Task 3 Print your current disk configuration. “How to Display Your Disk Configuration” 


___ Task 4 Include the disk units that you want to “How to Include a Disk Unit in Device 
protect in device parity protection. Parity Protection” on page 431 

___ Task 5 Add nonconfigured disk units to the correct |“How to Add Disk Units to an Auxiliar 
ASPs. See note 1 and note 2. Storage Pool” on page 403 

___ Task 6 If you created a new ASP on your system “How to Change the Storage Threshold for 


when you added disk units, the system set jan Auxiliary Storage Pool” on page 406 
the storage threshold of the ASP to 90%. If 
you want a different threshold, change it. 
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Table 64. Adding Disk Units to an Existing Input/Output Adapter—Tasks (continued) 


Task What To Do Where To Read More About It 


“How to Change the Storage Threshold for 
the System Auxiliary Storage Pool” on 


Task 7 Specify the storage threshold for the system 
ASP. If you use the QSTGLOWLMT and 
QSTGLOWACN system values, you can 
prevent the system ASP from filling to 
capacity and causing an abnormal shutdown. 


___ Task 8 Verify that your disk configuration is correct |“How to Display Your Disk Configuration” 


and print a copy for your records. lon page 397 
___ Task 9 End DST or SST. “How to Stop Dedicated Service Tools 


(DST)” on page 396for|’Stopping System| 
Service Tools (SST)” on page 396 


You can add the disk units to an existing ASP or you can add them to a new ASP. 


If you are adding disk units to an ASP that has mirrored protection and the new disk units do not have 
device parity protection, you must add pairs of disk units that have identical capacities. 


Adding a New Input/Output Adapter—Checklist 4 


This checklist shows the sequence of tasks that you use to add a new input/output 
adapter (IOA) and disk units to your system. Use this checklist if you plan to 
protect some or all of the new disks with device parity protection. 


You can use this procedure whether or not you have mirrored protection on your 
system because you start device parity protection before you add the disk units to 
an ASP. If you do have mirrored protection and you are adding disks that do not 
have device parity protection, you must add them in pairs that have equal 
capacities. You can use either DST or SST to perform the tasks in this checklist. If 
you use SST, you can perform the tasks while your system is active. If you use 
DST, you must stop your system to perform the tasks in this checklist. 


Note: If you do not plan to start device parity protection for any of the new disks, 
use the procedure in checklist 2 to add them. 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as 
you or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you diagnose any 
problems that occur. 


Attention: When you perform the tasks in this checklist, the system moves large 
amounts of data. Make sure that you have saved your system completely in the 
event that you need to recover from an error situation. 


Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 


Table 65. Adding a New input/output adapter—Tasks 


Task What To Do Where To Read More About It 


__ Task 1 Install the new input/output adapter in the 
system. This is normally done by a service 
representative. 


___ Task 2 Physically attach disk units to the new IOA. 
This is normally done by a service 
representative. 
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Table 65. Adding a New input/output adapter-Tasks (continued) 
Task What To Do Where To Read More About It 


___ Task 3 Start DST. “How to Start Dedicated Service Tools 


(DST)” on page 395 
___ Task 4 Print your current disk configuration. “How to Display Your Disk Configuration” 
lon page 397 


___ Task 5 Start device parity protection for the IOA. “How to Start Device Parity Protection for an| 
Input/Output Adapter” on page 42 


___ Task 6 Add nonconfigured disk units to the correct |“How to Add Disk Units to an Auxiliary 
ASPs. Storage Pool” on page 403 


___ Task 7 If you created a new ASP on your system “How to Change the Storage Threshold for 
when you added disk units, the system set jan Auxiliary Storage Pool” on page 406 
the storage threshold of the ASP to 90%. If 


you want a different threshold, change it. 


___ Task 8 Specify the storage threshold for the system |““How_to Display Your Disk Configuration” 


ASP. If you use the QSTGLOWLMT and 
QSTGLOWACN system values, you can 

prevent the system ASP from filling to 

capacity and causing an abnormal shutdown. 


___ Task 9 Verify that your disk configuration is correct |How to Display Your Disk Configuration” 


and print a copy for your records. 
___ Task 10 End DST. “How to Stop Dedicated Service Tools 


(DST)” on page 396) 


Notes: 
1. You can add the disk units to an existing ASP or you can add them to a new ASP. 


2. If you are adding disk units to an ASP that has mirrored protection and the new disk units do not have device 
parity protection, you must add pairs of disk units that have identical capacities. 


Moving Disk Units Between Non-Mirrored Auxiliary Storage 
Pools—Checklist 5 


This checklist shows the sequence of tasks that you use to move one or more disk 
units from one ASP to another ASP. Use these tasks when you do not have 
mirrored protection active for the ASPs. You must stop your system and use DST 
to perform the tasks in this checklist. 


Note: You cannot move disk units to or from an independent ASP. 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as 
you or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you diagnose any 
problems that occur. 


Attention: When you perform the tasks in this checklist, the system moves large 
amounts of data. Make sure that you have saved your system completely in the 


event that you need to recover from an error situation. 


Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 
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Table 66. Moving Disk Units Between ASPs—Tasks 


Task What To Do Where To Read More About It 
__ Task 1 Print your current disk configuration. “How to Display Your Disk Configuration” 
lon page 397 
___ Task 2 Calculate the space requirements for both the |“Calculating Space Requirements for an 
source and target ASPs for the disk units. Auxiliary Storage Pool” on page 414 
___ Task 3 Use option 21 from the Save menu to save “Save your server with the GO SAVE 
your entire system. command” on page 15 
___ Task 4 Start DST. “How to Start Dedicated Service Tools 
(DST)” on page 395 
___ Task 5 Move the disk units. “How to Move a Disk Unit to a Different 
Auxiliary Storage Pool” on page 409 
___ Task 6 If you created a new ASP on your system “How to Change the Storage Threshold for 
when you moved disk units, the system set [an Auxiliary Storage Pool” on page 406 
the storage threshold for the ASP to 90%. If 
you want a different threshold, change it. 
___ Task 7 Specify the storage threshold for the system |“How to Change the Storage Threshold for| 
ASP. If you use the QSTGLOWLMT and the System Auxiliary Storage Pool” on 
QSTGLOWACN system values, you can 
prevent the system ASP from filling to 
capacity and causing an abnormal shutdown. 
___ Task 8 Verify that your disk configuration is correct |How to Display Your Disk Configuration” 
and print a copy for your records. 
___ Task 9 End DST. “How to Stop Dedicated Service Tools| 
(DST)” on page 396) 
___ Task 10 If necessary, move objects between ASPs. “Transferring Objects between Auxiliar 


Storage Pools” on page 416 


Moving Disk Units Between Mirrored Auxiliary Storage 
Pools—Checklist 6 


This checklist shows the sequence of tasks that you use to move one or more disk 
units from one ASP to another ASP. Use these tasks when one or more or the ASPs 
involved in the move has mirrored protection. You cannot use the move unit 
procedure when mirrored protection is active. Instead, you remove mirrored pairs 
from the source ASP and add them to the target ASP. You must stop your system 
and use DST to perform the tasks in this checklist. 


Note: You cannot move disk units to or from an independent ASP. 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as 
you or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you diagnose any 
problems that occur. 


Attention: When you perform the tasks in this checklist, the system moves large 
amounts of data. Make sure that you have saved your system completely in the 


event that you need to recover from an error situation. 


Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 
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Table 67. Moving Disk Units Between ASPs with mirrored protection—Tasks 


Task What To Do Where To Read More About It 
__ Task 1 Print your current disk configuration. “How to Display Your Disk Configuration” 
lon page 397 


___ Task 2 Calculate the space requirements for the “Calculating Space Requirements for an 
ASPs that are involved in moving disk units. |Auxiliary Storage Pool” on page 414 


___ Task 3 Use option 21 from the Save menu to save “Save your server with the GO SAVE 
your entire system. command” on page 15 


___ Task 4 Start DST. “How to Start Dedicated Service Tools 


(DST)” on page 395 


___ Task 5 Remove disk units that you plan to add toa _ |“How to Remove a Disk Unit from a 


different ASP. Auxiliary Storage Pool” on page 411 


___ Task 6 Add nonconfigured disk units to the correct 
ASPs. See note 1. 


___ Task 7 If you created a new ASP on your system “How to Change the Storage Threshold for 
when you added disk units, the system set jan Auxiliary Storage Pool” on page 406 


the storage threshold of the ASP to 90%. If 
you want a different threshold, change it. 


“How to Change the Storage Threshold for 


the System Auxiliary Storage Pool” on 


___ Task 8 Specify the storage threshold for the system 
ASP. If you use the QSTGLOWLMT and 
QSTGLOWACN system values, you can 
prevent the system ASP from filling to 
capacity and causing an abnormal shutdown. 


___ Task 9 If you created any new ASPs and you want _|“How to Start Mirrored Protection” on 


those ASPs to have mirrored protection, start 
mirrored protection now. 


___ Task 10 Verify that your disk configuration is correct |“How to Display Your Disk Configuration” 


and print a copy for your records. 
__ Task 11 End DST. “How to Stop Dedicated Service Tools 


(DST)” on page 396) 


“Transferring Objects between Auxiliar 


Storage Pools” on page 416 


___ Task 12 If necessary, move objects between ASPs. 


If you are adding disk units to an ASP that has mirrored protectionand the new disk units do not have 
device parity protection, you must add pairs of disk units that have identical capacities. 


Deleting an Auxiliary Storage Pool—Checklist 7 


This checklist shows the sequence of tasks that you use to delete a user ASP. You 
must stop your system and use DST to perform the tasks in this checklist. 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as 
you or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you diagnose any 
problems that occur. 


Attention: When you perform the tasks in this checklist, the system moves large 
amounts of data. Make sure that you have saved your system completely in the 
event that you need to recover from an error situation. Also note that when an 
ASP is deleted, all data remaining in that ASP is lost. 


Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 
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Table 68. Deleting an Auxiliary Storage Pool—Tasks 


Task What To Do Where To Read More About It 
__ Task 1 Print your current disk configuration. “How to Display Your Disk Configuration” 
lon page 397 
___ Task 2 Calculate the space requirements for the “Calculating Space Requirements for an 
remaining ASPs. Auxiliary Storage Pool” on page 414 
___ Task 3 Use option 21 from the Save menu to save “Save your server with the GO SAVE 
your entire system. command” on page 15 
___ Task 4 Remove objects from the ASP that you are “Transferring Objects between Auxiliary 
deleting or move the objects to a different Storage Pools” on page 416 
ASP. 
___ Task 5 Start DST. “How to Start Dedicated Service Tools 
(DST)” on page 395 
___ Task 6 Delete the ASP. This procedure places all of |“How_to Delete an Auxiliary Storage Pool” 
the disks that were assigned to the deleted 
ASP in nonconfigured status. 
___ Task 7 Add nonconfigured disk units to the correct |“How_ to Add Disk Units to an Auxiliar 
ASPs. See note 1. Storage Pool” on page 403 
___ Task 8 If you created a new ASP on your system “How to Change the Storage Threshold for 
when you added disk units, the system set [an Auxiliary Storage Pool” on page 406 
the storage threshold of the ASP to 90%. If 
you want a different threshold, change it. 
___ Task 9 Specify the storage threshold for the system |“How to Change the Storage Threshold for| 
ASP. If you use the QSTGLOWLMT and the System Auxiliary Storage Pool” on 
QSTGLOWACN system values, you can 
prevent the system ASP from filling to 
capacity and causing an abnormal shutdown. 
___ Task 10 Verify that your disk configuration is correct |“How to Display Your Disk Configuration” 
and print a copy for your records. 
___ Task 11 End DST. “How to Stop Dedicated Service Tools| 
(DST)” on page 396) 
___ Task 12 If necessary, move objects between ASPs. “Transferring Objects between Auxiliar 


Storage Pools” on page 416 


If you are adding disk units to an ASP that has mirrored protectionand the new disk units do not have 
device parity protection, you must add pairs of disk units that have identical capacities. 


Removing Disk Units Without Device Parity 
Protection—Checklist 8 


This checklist shows the sequence of tasks that you use to remove one or more 
disk units from your system when the disk units do not have device parity 
protection. Use these tasks when you are permanently removing disk units from 
your system.Do not use these tasks when you are repairing or replacing a failed 
disk unit. You must stop your system and use DST to perform the tasks in this 


checklist. 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as 
you or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you diagnose any 


problems that occur. 
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Attention: When you perform the tasks in this checklist, the system moves large 
amounts of data. Make sure that you have saved your system completely in the 
event that you need to recover from an error situation. 


Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 


Table 69. Removing Disk Units That Do Not Have Device Parity Protection—Tasks 


Task What To Do Where To Read More About It 
__ Task 1 Print your current disk configuration. “How to Display Your Disk Configuration” 
lion page 397 


___ Task 2 Calculate the space requirements for the “Calculating Space Requirements for an 
ASPs that are involved in removing disk Auxiliary Storage Pool” on page 414 


units. 
___ Task 3 Use option 21 from the Save menu to save “Save your server with the GO SAVE 
your entire system. 


___ Task 4 Start DST. “How to Start Dedicated Service Tools 


(DST)” on page 395 


___ Task 5 Remove disk units that you plan to remove _|“How_to Remove a Disk Unit froma 


from the system. Auxiliary Storage Pool” on page 411 

___ Task 6 Verify that your disk configuration is correct |“How to Display Your Disk Configuration” 
and print a copy for your records. 

___ Task 7 End DST. “How to Stop Dedicated Service Tools 


(DST)” on page 396) 


Note: This checklist works only if at least one unit remains in the ASP and there is 
enough capacity remaining. 


Removing Disk Units That Have Device Parity Protection from 
an ASP Without Mirrored Protection—Checklist 9 


This checklist shows the sequence of tasks that you use to remove one or more 
disk units from an Input/Output Adapter. These tasks apply when the ASPs 
containing the disk units do not have mirrored protection and when device parity 
protection is started for the IOA. Use these tasks when you are permanently 
removing disk units from your system. Do not use these tasks when your are 
repairing or replacing a failed hard disk. You must stop your system and use DST 
to perform the tasks in this checklist. 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as 
you or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you diagnose any 
problems that occur. 


Attention: When you perform the tasks in this checklist, the system moves large 
amounts of data. Make sure that you have saved your system completely in the 


event that you need to recover from an error situation. 


Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 
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Table 70. Removing Disk Units from an IOA and a Non-Mirrored ASP-Tasks 


Task What To Do Where To Read More About It 
__ Task 1 Print your current disk configuration. “How to Display Your Disk Configuration” 
lon page 397 
___ Task 2 Calculate the space requirements for the “Calculating Space Requirements for an 
ASPs that are involved in removing disk Auxiliary Storage Pool” on page 414 
units. 
___ Task 3 Use option 21 from the Save menu to save “Save your server with the GO SAVE 
your entire system. command” on page 15 
___ Task 4 Start DST. “How to Start Dedicated Service Tools 
(DST)” on page 395 
___ Task 5 Remove disk units that you plan to remove _[“How_to Remove a Disk Unit froma 
from the system. Auxiliary Storage Pool” on page 411 
___ Task 6 Exclude the disk units from device parity “How to Exclude a Disk Unit from Device 
protection. If you were successful in Parity Protection” on page 432 
excluding the disk units, skip to task 8. 
Otherwise, continue with task 7. 
___ Task 7 Stop device parity protection for the IOA. “How to Stop Device Parity Protection on an 
Input/Output Adapter” on page 429 
___ Task 8 Physically remove disk units. This is 
normally done by a service representative. If 
you stopped device parity protection in task 
7, then continue with task 9. If you did not 
stop device parity protection, then skip to 
task 10. 
___ Task 9 Start device parity protection for the IOA. “How to Start Device Parity Protection for an| 
Input/Output Adapter” on page 42 
___ Task 10 Verify that your disk configuration is correct |“How to Display Your Disk Configuration” 
and print a copy for your records. 
___ Task 11 End DST. “How to Stop Dedicated Service Tools 


— 


DST)” on page 396 


Removing Disk Units That Have Device Parity Protection from 
an ASP With Mirrored Protection—Checklist 10 


This checklist shows the sequence of tasks that you use to remove one or more 
disk units from an input/output adapter. These tasks apply when the ASPs that 
contain the disk units have mirrored protection and when the disk units have 
device parity protection. Use these tasks when your are permanently removing 
disk units from your system. Do not use these tasks when you are repairing or 
replacing a failed disk unit. You must stop your system and use DST to perform 


the tasks in this checklist. 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as 
you or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you diagnose any 


problems that occur. 


Attention: When you perform the tasks in this checklist, the system moves large 
amounts of data. Make sure that you have saved your system completely in the 
event that you need to recover from an error situation. 
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Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 


Table 71. Removing Disk Units from an IOA and a Mirrored ASP-Tasks 


Task What To Do Where To Read More About It 
__ Task 1 Print your current disk configuration. “How to Display Your Disk Configuration” 
lion page 397 
___ Task 2 Calculate the space requirements for the “Calculating Space Requirements for an 
ASPs that are involved in removing disk Auxiliary Storage Pool” on page 414 
units. 
___ Task 3 Use option 21 from the Save menu to save “Save your server with the GO SAVE 
your entire system. command” on page 15 
“How _to Start Dedicated Service Tools| 


___ Task 4 Start DST. “How to Start Dedicated Service Tools 
DST)” on page 395 


i—~ 


___ Task 5 Remove disk units that you plan to remove [How _to Remove a Disk Unit froma 
from the system. Auxiliary Storage Pool” on page 411 


Task 6 Exclude the disk units from device parity “How to Exclude a Disk Unit from Device 
i protection. If you were successful in arity Protection” on page 432 
excluding the disk units, skip to task 9. 
Otherwise, continue with task 7. 


= 


Task 7 Stop mirrored protection for the ASPs that “How to Stop Mirrored Protection” on 
-_ will have disk units removed. When you page 44) 
stop mirrored protection, one disk unit from 
each mirrored pair becomes nonconfigured. 


See note 1. 
___ Task 8 Stop device parity protection for the IOA. “How to Stop Device Parity Protection on an 
Input/Output Adapter” on page 429 
___ Task 9 Physically remove disk units. This is 


normally done by a service representative. If 
you stopped device parity protection in task 
8, then continue with task 10. If you did not 
stop device parity protection, then skip to 


task 14. 
___ Task 10 Start device parity protection for the IOA. “How to Start Device Parity Protection for an| 
Input/Output Adapter” on page 42 
___ Task 11 Add nonconfigured disk units to the correct |“How to Add Disk Units to an Auxiliary, 
ASPs. These disks became nonconfigured Storage Pool” on page 403 
when you stopped mirrored protectionin 
task 7. 
___ Task 12 If you created a new ASP on your system “How to Change the Storage Threshold for 


when you added disk units, the system set jan Auxiliary Storage Pool” on page 40 
the storage threshold of the ASP to 90%. If 
you want a different threshold, change it. 


___ Task 13 Start mirrored protection for the ASPs that “How to Start Mirrored Protection” on 
had mirrored protection stopped in task 7. page 443 

___ Task 14 Verify that your disk configuration is correct |How to Display Your Disk Configuration” 
and print a copy for your records. ion page 397 

___ Task 15 End DST. “How to Stop Dedicated Service Tools 


i—~ 


DST)” on page 396) 


You need to stop mirrored protection only if the ASP contains other disk units that are attached to the IOA 
and have device parity protection. 
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Using System Service Tools and Dedicated Service Tools 


Several backup and recovery procedures, including disk storage management, 
require the use of Dedicated Service Tools (DST) or System Service Tools (SST). 
This topic describes how to start and end SST and DST. It also provides a list of 
the options available through these tools. 


How to Start Dedicated Service Tools (DST) 

Use this procedure to start_DST. If the IPL or Install the System menu is already 
displayed, start with step 

1. Ensure that the keystick is in the system unit control panel. 

2. Place the system in manual mode. 

3. Power down the system: 


PWRDWNSYS OPTION(*CNTRLD) DELAY (600) 
RESTART(*YES) IPLSRC(B) 


;— Attention logical partitioning users! 
If you are going to use this command on the primary partition, be sure to 
power off all secondary partitions before running the command. 


Note: If you are sure that no jobs are running on your system, you can specify 
OPTION(*IMMED) when you power down the system. Otherwise, specify a 
delay time that is sufficient to allow jobs to end normally. 


4. When the IPL completes, the IPL or Install the System menu appears. 


IPL or Install the System 
Select one of the following: 
. Perform an IPL 
. Install the operating system 


. Use Dedicated Service Tools (DST) 
. Perform automatic installation of the operating system 
5. Save Licensed Internal Code 


5. Select option 3 (Use Dedicated Service Tools (DST)) and press the Enter key. 
The Dedicated Service Tools (DST) Sign On display is shown. 


Dedicated Service Tools (DST) Sign On 
Type choice, press Enter. 


DSTAUSEn Tcecnsserss core aicnget cans 
DST password). 2 ss. oe = 


6. In the DST user field, type QSECOFR. In the DST password field, type your DST 
security-level or full-level password. On a new system, the password is 
QSECOEFR. The password is case sensitive; use all capital letters. You should 
change this password after you complete your installation procedures. The 
iSeries Security Reference book has more information about DST passwords. 


The Use Dedicated Service Tools (DST) menu is shown. 
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Use Dedicated Service Tools (DST) 
Select one of the following: 
. Perform an IPL 
. Install the operating system 
. Work with licensed internal code 
. Work with disk units 
. Work with DST environment 
. Select DST console mode 
. Start a service tool 
. Perform automatic installation of the operating system 
. Work with save storage and restore storage 
. Work with remote DST support 


GOON anBWNMYE 


ee 


How to Stop Dedicated Service Tools (DST) 

Use this procedure to end DST: 

1. If you do not want to see the displays for a manual initial program load (IPL), 
return the system to automatic mode. If you want to see the displays, leave the 
system in manual mode. 

2. Press F3 until you return to the Use Dedicated Service Tools (DST) menu. 


3. From the Use Dedicated Service Tools (DST) menu, select option 1 (Perform an 
IPL). 


Note: Do not perform an IPL if you are performing a complete system 
recovery. 

The system may take significantly longer than normal to complete the IPL. 

Some functions that you perform by using DST, such as starting mirrored 

protection, require the system to do additional work during the IPL before the 

system is available for your use. 


Starting System Service Tools (SST) 

You can access system service tools doing the following: 

1. Use the Start System Service Tools (STRSST) command or by selecting the 
option for problem handling from the iSeries Main menu. From the Problem 
Handling menu, select the option for system service tools. 

2. At the Start Service Tools (STRSST) Sign On display, enter your service tools 
user profile and password. For more information about about Service tools user 
profiles, see Tips and Tools for Securing Your iSeries. 

3. Press Enter. 


4. The System Service Tools (SST) menu appears: 


System Service Tools (SST) ip 
Select one of the following: 
1. Start a service tool 
2. Work with active service tools 
3. Work with disk units 
4. Work with diskette data recovery 
5. Work with system partitions , 


Stopping System Service Tools (SST) 


To end system service tools, do the following: 

1. Press F3 (Exit) until you return to the System Service Tools (SST) menu. 

2. Press F3 (Exit) again. You are shown the Exit System Service Tools display. 
3. Press the Enter key to end SST. 
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How to Display Your Disk Configuration 


This topic describes how to display or print your current disk configuration. It also 
explains some of the fields that appear on the display or listing. For some 
purposes, such as planning a mirrored configuration, you need to view your disk 
configuration both from a hardware perspective and from a software perspective. 
The hardware perspective shows how the disk units are attached by bus, IOA, and 
controller. The software perspective shows how disk units are assigned to ASPs 
and how they are protected. 


You can use DST, SST, or commands to display your disk configuration. When you 
are planning changes to your disk configuration, use SST and commands to print 
your current configuration before you begin to make changes. After you have 
made changes, you can use DST to verify the new configuration before you end 
DST. 


Displaying Your Disk Configuration—Hardware View 

When you display your hardware disk configuration, you see all disk-related 
components that are physically attached to your system. This includes disk units 
whose software status is nonconfigured because they are not assigned to an ASP 


yet. 


This topic describes both the DST method and the command method for 
displaying your disk hardware configuration. 


Displaying Disk Hardware Configuration—-Command Method: ‘To display the 

hardware configuration of disk units on your system, do the following: 

1. Ona command line, type WRKHDWRSC TYPE(*STG) and press the Enter key. The 
Work with Storage Resources display appears. The display shows buses, IOPs, 
and controllers. 


a 
Work with Storage Resources . 
System: | RCHASDP4 


Type options, press Enter. 
9=Work with resource 


Opt Resource Status Text 

CMBO1 Operational Combined function IOP 
Dco1 Operational Disk Storage Controller 
Dco2 Operational Disk Storage Controller 
DCO5 Operational Tape Controller 


2. If you want to see the detail about disk units that are attached to a controller, 
type 9 (Work with resource) in the Option column for the controller. 


To print the hardware configuration of disk units on your system, do the 
following: 


1. On a command line, type DSPHDWRSC TYPE(*STG) OUTPUT(*PRINT) and press the 
Enter key.|Figure 31 on page 398|}shows part of the listing that you receive: 
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Display Spooled File 


Riles <2) sate cy sOSYSPRI. Page/Line 1/1 
Controls: ws. sos, +15 Columns 1 - 78 
Find: 2.5 a &e % 


Display Hardware Resources 
5716SS1 V3R6M0 950602 
Storage Resources List 


Serial Part Frame 
Resource Type-Model Number Number ID 
CMBO1 9162-001 10-00000 0000086G7917 1 
DCe1 6602-030 00-0193825 1 
DDOO1 6602-030 00-0193825 1 
DCe2 6602-030 00-17900 1 
DDeEO2 6602-030 00-17900 1 


Figure 31. Display Hardware Resource Listing 


Displaying Disk Hardware Configuration-DST Method: When you are using 
DST, you can use the following method to display your disk hardware 
configuration: 


1. If you are not already using DST, perform a manual IPL to start DST. See|”How] 
to Start Dedicated Service Tools (DST)” on page 395 
2. From the Use Dedicated Service Tools (DST) menu, do the following: 


a. Select option 7 (Start a service tool). 


b. Select option 4 (Hardware service manager) on the Start a Service Tool 
display. 
3. To print the hardware disk configuration, press F6 (Print configuration). If your 
system already has a printer defined for DST, the output is sent to that printer. 
If you do not have a DST printer defined, you are prompted with a list of 
attached printers. When you are using DST, output goes directly to the printer 
because spooling is not active. 


4. To display the configuration, select option 2 (Logical hardware resources) from 
the Hardware Service Manager menu. From this display, you can select to show 
system bus, processor, or main storage resources. 

5. To see additional detail, type 5 (Display detail) in the Option column next to 
each controller and press the Enter key. 

6. If you have no other tasks to perform, end DST. (See |“How to Stop Dedicated| 
Service Tools (DST)” on page 396 


) 


Displaying Your Disk Configuration—Software View 

When you display your software disk configuration, you see how disk units are 
assigned to ASPs and how they are protected. A separate display shows disk units 
that are attached to the system but have not been assigned to an ASP 
(nonconfigured status). 


To display the software configuration of disk units on your system, do the 
following: 


1. If you are not already using DST, perform a manual IPL to start DST. See|“How] 
2. From the Use Dedicated Service Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 
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b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 


c. Select option 1 (Display disk configuration) on the Work with Disk 
Configuration display. 


d. Select option 1 (Display disk configuration status) on the Display Disk 
Configuration display. 


or from the System Service Tools (SST) menu, do the following: 


a. Select option 3 (Work with disk units). 


b. Select option 1 (Display disk configuration) on the Work with Disk Units 
display. 


The Display Disk Configuration menu appears. 


S 


AoawPwNnr 


Select one of 
Display 
Display 
Display 
Display 
Display 
Display 


Display Disk Configuration 


the following: 

disk configuration status 
disk configuration capacity 
disk configuration protection 
non-configured units 

device parity status 

disk hardware status 


a rn 


me 


3. Select option 1 to see the Display Disk Configuration Status display: 


fea Display Disk Configuration Status ) 
Serial Resource 
ASP Unit Number Type Model Name Status 
1 Unprotected 
1 @0-0193825 6602 030 DDOO1 Configured 
2 00-0163477 6602 074 DDO19 DPY/Active 
3 00-0190494 6602 070 DD0O36 DPY/Active 
6 @0-17900 6602 030  DDOO2 Configured 
3 Unprotected 
4 0Q0-0330477 6602 074 DDQ05 DPY/Active 
5 00-0323200 6602 074 DD0O33 DPY/Active 
Press Enter to continue. 
F3=Exit F5=Refresh F9=Display disk unit details 
Fll=Disk configuration capacity F12=Cancel 5, 


Note: If you are performing a complete system restore, all the disk units on the 


system may not report in right away. Verify that the number of disk 
units displayed matches the number of disk units physically attached to 
the system. If they do not match, wait a few minutes and press F5 
(Refresh) until all of the disk units report in. 


4. If the lower right of the display says More..., you can page forward to see 
additional units. 
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5. To display the capacity of your disk units and how much capacity is used, 
press F11 from the Display Disk Configuration Status display or select option 2 
from the Use Dedicated Service Tools (DST) menu: 


i Display Disk Configuration Capacity ) 
--Protected-- --Unprotected-- 
ASP Unit Type Model Threshold Overflow Size %Used Size Used 
1 90% No 1805 * 2063 * 
1 6602 030 0 0.00% 1031 * 
2 6602 074 773 * 0 0.00% 
3 6602 070 1031 * 0 0.00% 
6 6602 030 0 0.00% 1031 * 
3 90% No 1547 * 0 0.00% 
4 6602 074 773 * 0 0.00% 
5 6602 074 3 * 0 0.00% 
S / 


6. To display the disk protection that is configured for each disk unit, press F11 
again: 

7. To display nonconfigured disk units, press F1l from the Display Disk 
Configuration Protection display or select option 4 from the Display Disk 
Configuration menu: 


Display Non-Configured Units 
Serial Resource 


Number Type Model Name Capacity Status 
00-0313374 6602 074 DD0O3 TI3 DPY/Active 


8. To print the software disk configuration, use the print key from the displays. If 
your system already has a printer defined for DST, the output is sent to that 
printer. If you do not have a DST printer defined, you are prompted with a list 
of attached printers. When you are using DST, output goes directly to the 
printer because spooling is not active. 


9. If you have no other tasks to perform, end DST or SST.(See 
Dedicated Service Tools (DST)” on page 396] or |“Stopping System Service Tools 
(SST)” on page 3961) 


Interpreting Disk Configuration and Status Displays 

This topic explains some of the fields that appear on the displays that you use to 
look at your disk configuration and status. You can view online information for all 
the fields and their possible values. 


Unit Field: A unit number is assigned by the system to identify a specific disk unit. 
The unit number is a software function and does not appear when you display the 
hardware configuration. When disk units are protected by mirrored protection, 
both disk units in a mirrored pair are assigned the same unit number. 


Resource Name Field: The system resource manager assigns a resource name to 
every hardware device that is physically attached to the system. This resource 
name is the link between the hardware and the software definition of the 
hardware. When you add a disk unit to an ASP, you use the resource name to 
identify which disk unit to add. 
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Status Field for the Auxiliary Storage Pool: The display shows the status of an 
entire ASP. This status indicates the software disk protection that is in effect for the 
ASP. The possible values are: 


Unprotected Mirrored protection is not active for the ASP. However, device parity 
protection may be active for some or all of the disk units in the ASP. You 
need to look at the individual disk units to determine the level of 
protection for the ASP. 


Mirrored The ASP is fully protected. Mirrored protection has been started for the 
ASP. All of the disk units in the ASP are protected either by mirrored 
protectionor by device parity protection. 


Status—Disk Unit: The display also shows the status of individual disk units. The 


possible values are: 


Operational 


The disk unit is operational and ready to accept input or output 
operations. 


Not operational 


The device cannot communicate with the IOP. You should verify 
that the unit is powered on. 


Not ready The device cannot perform media-related functions, but it can still 
communicate with the IOP. 
Busy The device is not available for processing any commands on this 


connection. 


Read/write protected 


The device cannot process either a read or a write operation. A 
device may be in this state due to a cache problem, a device 
configuration problem, or other types of problems that could cause 
a data integrity exposure. 


Write protected 


Performance degraded 


The device cannot accept write operations. Read operations are 
allowed. 


The device is functional, but performance may be impacted due to 
other hardware problems (such as a problem with the IOP cache). 


Redundant failure 


The device is functional, but availability may be impacted due to 
other problems (such as a redundant power supply problem). 
Service is required to prevent additional failures that will stop input 
and output operations to the device. 


DPY/ Failed 


This unit is part of a disk unit subsystem that has device parity 
protection. The disk unit failed within its device parity set, causing 
the loss of data protection for the device parity set. 


DPY/Unprotected 


This unit is part of a disk unit subsystem that has device parity 
protection. Data protection is no longer in effect due to a failure in 
another resource. 


DPY/Rebuilding 


This unit is part of a disk unit subsystem that has device parity 
protection. Data protection is being rebuilt. 


DPY/ Active 


DPY/Resyncing 


This unit is part of a disk unit subsystem that has device parity 
protection. The unit is operational and ready to accept input or 
output operations. 


This unit is part of a disk unit subsystem that has device parity 
protection. The subsystem is in the process of recreating the 
redundancy data for the device parity set. All units in the set that 
are being synchronized will have this status. 


DPY/Unknown 


This unit is part of a disk unit subsystem that has device parity 
protection. The status of this unit is not known to the system. 
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Active 


This unit is one of a mirrored pair. It is capable of having data 
written to it or read from it. 


Suspended 


This unit is one of a mirrored pair. It is not capable of havingdata 
written to it or read from it. The data on this unit is not current. For 
example, if the disk needs repair action or has been manually 
suspended, it would be in a Suspended state. 


Resuming 


This unit is one of a mirrored pair. The current data is being copied 
(or will be copied) to this unit from the other active unit of the 
mirrored pair. 


Unprotected 


The device is in a state that cannot be determined. 
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Chapter 20. Working with Auxiliary Storage Pools 


This chapter contains procedures for working with auxiliary storage pools (ASPs). 
When you are making changes to the disk configuration on your system, refer to 


Chapter 19, “Procedures for Configuring Disks and Disk Protection”| for the correct 


sequence of steps for your situation. 


Support for independent ASPs is provided through iSeries Navigator. If you want 
to work with independent ASPs, you can find information in the Information 
Center at the following Web site: 


http://www. ibm.com/eserver/iseries/infocenter 


Both the Information Center and iSeries Navigator refer to ASPs as Disk Pools. 


How to Add Disk Units to an Auxiliary Storage Pool 


[—_ Do Things in the Right Sequence 


* If you want to have device parity protection for the disks that you are 
adding, you should start device parity protection before you add the disk 
units to an ASP. 


* If you have more than one ASP on your system, you should plan how you 
want to add the new disk units before you begin this procedure. The topic, 
Information Center contains more information. You can access the 
Information Center from the from the following Web site: 


http://www. ibm.com/eserver/iseries/infocenter 


When you (or your service representative)physically attach a new disk unit to your 
system, the status of the new disk unit is nonconfigured. Nonconfigured status 
means that a disk unit has not yet been assigned to an ASP on the system. You can 
assign disk units to an existing ASP or to a new ASP. You create a new ASP simply 
by assigning disk units to it. 


To assign nonconfigured disks to an ASP, do the following: 
1. If you are not already using DST, perform a manual IPL to start DST. See|”How] 
2. From the Use Dedicated Service Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 
b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 
c. Select option 3 (Work with ASP configuration) on the Work with Disk 
Configuration display. 
or from the System Service Tools (SST) menu, 
a. Select option 3 (Work with disk units). 


b. Select option 2 ( Work with disk configuration) on the Work with Disk 
Units display. 
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3. Select the option to add units to ASPs and balance data. The Specify ASPs to 
Add Units to display appears. It lists all the disk units that have a status of 


nonconfigured. 
e Specify ASPs to Add Units to 

Specify the ASP to add each unit to. 
Specify Serial Resource 

ASP Number Type Model Capacity Name 

== 00-0103706 6602 030 1031 DDO31 

on 00-1000341 9337 211 542 DDde12 

a 00-5000341 9337 211 542 DDOQ15 

ie 00-7000341 9337 211 542 DDO11 

a 00-3000341 9337 211 542 DDde14 

oes 00-2000341 9337 211 542 DDe13 

( 00-61300 6603 074 1475  DDO06 

Bie 00-52262 6606 074 1475 DDO08 

als 00-86978 6606 050 1967 DDOOI 

2a 00-95744 6603 074 1475 DDOO5 

2% 00-47657 6606 074 1475 ~=DDOO7 

aa 00-0238703 6602 074 773 ~—-DDO52 

aay, 00-0128330 6602 074 773 ~~“ DDOS1 

More... 

F3=Exit F5=Refresh F1l=Display disk configuration capacity 
ee rercencel 


J 


Note: If you are performing a complete system restore, all the disk units on the 
system may not report in right away. Verify that the number of disk 
units displayed matches the number of disk units physically attached to 
the system. If they do not match, wait a few minutes and press F5 
(Refresh) until all of the disk units report in. 


4. Type an ASP number next to each disk unit that you want to configure. If you 
type an ASP number that does not currently exist on your system, the system 
will create that ASP. 


Number 1 is reserved for the system ASP. You can enter a number from 2 to 32. 
Numbers 33 to 99 are reserved for independent ASPs. 


The Confirm Add Units display appears: 
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ze 


The Confirm Add Units display shows what the entire system configuration 
will be when you add the units. If you have more than one ASP on your 


Confirm Add Units 
Add will take several minutes for each unit. 
have the displayed protection after the unit(s) are added. 
Press Enter to confirm your choice for 1=Add units. 
Press F9=Capacity Information to display the resulting capacity. 
Press F12=Cancel to return and change your choice. 
Serial Resource 
ASP Unit Number Type Model Name 
1 
1 00-48519 6606 030 DDO10 
2  00-86978 6606 050  DDO0I 
3. 00-52262 6606 074 DDO0D8 
4 00-61300 6603 074 DDO06 
2 
5 00-95744 6603 074 DDOO5 
6 00-47657 6606 074 DDQOO7 
F9=Resulting Capacity F12=Cancel 


The system will 


Protection 
Unprotected 
Unprotected 
Unprotected 
Device Parity 
Device Parity 
Unprotected 
Device Parity 
Device Parity 


system, verify this configuration against your planned configuration. 


5. You can press F9 (Resulting capacity) to see how the change will affect your 


disk utilization. You are shown the following display: 


ie 


following ASP capacities. 


Press Enter to continue. 


----------- Current---------- 
--Protected-- -Unprotected- 
ASP Threshold Size %Used Size %Used 
1 90% 0 0.00% 1967 23.98% 
2 90% 


Resulting Capacity 
The configuration change that you requested would result in the 


woonn----- Proposed---------- 
--Protected-- -Unprotected- 
Size Used Size %used 
2950 0.07% 3934 12.02% 
2950 0.07% 0 0.00% 


6. Press F12 (Cancel) to return to the Confirm Add Units display. 


7. If you are satisfied with the configuration, press the Enter key to add the disk 
units to the ASP. If you want to make changes, press F12 to return to step 


Adding units can take from several minutes to several hours. During that time, 


you are shown the Function Status display: 
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(~ Function Status 5) 


You selected to add units. 


5 % Complete 


The system updates the display periodically. 


Note: You can press F16 to return to the Use Dedicated Service Tools (DST) 
menu if you have other tasks to perform. However, you cannot perform 
any disk configuration tasks or end DST until the system has finished 
adding disk units. 


The time it takes the system to add units depends on the type, model, and size 
of each unit being added and the ability of the system to do multiple adds at 
the same time. 


8. If you have no other tasks to perform, end DST_or SST. (See 
Dedicated Service Tools (DST)” on page 396} or |“Stopping System Service Tools 
(SST)” on page 3961) 


How to Change the Storage Threshold for an Auxiliary Storage Pool 


The storage threshold for an ASP determines when the system warns you that the 
space allocated for the ASP is almost full. The default for an ASP is 90%. To change 
the storage threshold for an ASP, do the following: 


1. From the System Service Tools (SST) menu, do the following: 
a. Select option 3 (Work with disk units). 
b. Select option 2 (Work with disk configuration). 


Note: If you are not already using DST, see |‘How to Start Dedicated Service 
Tools (DST)” on page 395 

or from the Use Dedicated Service Tools (DST) menu, do the following: 

a. Select option 4 (Work with disk units). 

b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 

c. Select option 3 (Work with ASP configuration) on the Work with Disk 
Configuration display. 


If you are not already using DST, perform a manual IPL to start DST. See 
to Start Dedicated Service Tools (DST)” on page 395 

2. Select the option to work with the ASP threshold. The Select ASP to Change 
Threshold display is shown. 
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Select ASP to Change Threshold 
Type option, press Enter. 


1=Select 
--Protected-- --Unprotected-- 
Option ASP Threshold Overflow Size Used Size Used 
il 90% No 6046 0.31% 7676 6.36% 
1 2 90% No 2950 * 0 0.00% 


3. On the Select the ASP to Change Threshold display, select the ASP that you 
want to have a different threshold. Press the Enter key. The following display is 


shown. 
a Change Storage Threshold > 
--Protected-- --Unprotected-- 
ASP Threshold Overflow Size  %Used Size %Used 
2 90% No 2950 * 0 0.00% 


This is an unprotected ASP. The threshold represents the amount of 
unprotected storage used before a warning message is sent to the system 
operator. Type choice, press Enter. 

New threshold... <4... 3. 88% 1-100 


4. Type your choice for the New threshold prompt and press the Enter key. 


5. If you have no other tasks to perform, end DST or SST. (See 
Dedicated Service Tools (DST)” on page 396}or |“Stopping System Service Tools 
(SST)” on page 396}) 


How to Change the Storage Threshold for the System Auxiliary 


Storage Pool 


It is important to prevent the system ASP from filling to capacity. If this occurs, the 
system will end abnormally. You can try to avoid this by specifying a storage 
threshold that warns you of a potential space shortage. 


One way to establish this threshold is through Dedicated Service Tools (DST) or 
System Service Tools (SST). Use the same procedures as you would when setting 


the storag “How to Change the Storage 


Threshold for an Auxiliar Storage Pool” on page 406] for information on this 
procedure. 


Note: Establishing the threshold through DST will not prevent the system from 
ending abnormally. It will only notify you when the system ASP reaches the 
capacity threshold. 


You can also protect the system ASP from filling to capacity by using the 
QSTGLOWLMT and QSTGLOWACN system values. The QSTGLOWLMT system 
value specifies the percentage of unallocated auxiliary storage that is remaining 
when the critical storage lower limit is reached. If the system reaches that limit, the 
QSTGLOWACN system value specifies what action the system should take. Using 
this method allows the system to actively prevent an abnormal shutdown instead 
of simply sending a warning of the condition. 


Note: Using these system values does not affect any existing storage threshold that 
you may have set through DST. 
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You can use the QSTGLOWLMT and QSTGLOWACN system values on the 


following commands: 


RTVSYSVAL 
WRKSYSVAL 


CHGSYSVAL 
DSPSYSVAL 


The following procedure demonstrates how to use these sytem values. (The 


WRKSYSVAL command is used as an example.) 


1. At acommand line, type WRKSYSVAL and press Enter. You are shown the Work 


with System Values display. 


‘< Work with System Values » 
System: YOURSYS 
ROSHEETONI EO ra weparsier cs Starting characters of system value 
Subset by Type . F4 for list 
Type options, press Enter. 
2=Change 5=Display 
System 
Option Value Type Description 
_ QSTGLOWACN *STG Auxiliary storage lower limit action 
= QSTGLOWLMT *STG Auxiliary storage lower limit ) 


2. Type a 2 in the option field to change QSTGLOWACN and press Enter. You 
must have *ALLOBJ and *SECADM authority to change QSTGLOWACN. You 


are shown the Change System Value display. 


a Change System Value ) 
System value. ....: QSTGLOWACN 
Description .....: Auxiliary storage lower limit action 
Type choice, press Enter. 
AGENMOMN taeey couse ges cot se *MSG *MSG 
*CRITMSG 
*REGFAC 
*ENDSYS 
*PWRDWNSYS 
Xe ey 
3. On the Change System Value display, type the name of the action that you 


want the system to perform after reaching the critical storage lower limit. Press 
the Enter key. The actual actions that are performed by the action names are as 
follows: 


*MSG 
The system sends the CPI099C message to the QSYSMSG and QSYSOPR 
message queues. (The system also sends this message when you select any 
one of the other actions.) 


*CRITMSG 
The system sends the CPI099B critical message to the user who is specified 
in the service attribute to receive critical messages. 
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*REGFAC 
The system submits a job to call exit programs that are registered for the 
QIBM_QWC_OSTGLOWACN exit point. 


*ENDSYS 
The system ends to the restricted state. 


*PWRDWNSYS 
The system powers down immediately and restarts 


4. From a command line, type DSPSYSVAL and press the Enter key. The Display 
System Value screen is shown. 


Display System Value 


System value. ....: QSTGLOWLMT 
Description .... .: Auxiliary storage lower limit 
Lower limit: «34... 73: 1.0000 0-100 percent 


The lower limit value is the lowest amount of unused storage that can exist in 
the system ASP before the system performs the QSTGLOWACN action. (You 
can use the WRKSYSSTS command to view the amount of storage that is 
currently being used in the system ASP.) The system is shipped with the 
QSTGLOWLMT system value set to 5.0. Any change you make to this system 
value takes effect immediately. 


Note: If the DST threshold is above 95%, the lower limit value will be set to 
the difference between 100% and the threshold setting. For example, if 
the DST threshold is set to 98%, QSTGLOWLMT will be set to 2.0. (100 
— 98 = 2.) This only occurs at the time you install V4R2. 


How to Move a Disk Unit to a Different Auxiliary Storage Pool 


You may want to move a disk unit from one ASP to another. For example, you 
want to create a user ASP for journal receivers and move some of the disk units on 
your system to the new user ASP. You can accomplish this in one process. When 
you move a disk unit to an ASP that does not exist, the system creates the ASP. 


You may also decide to move disk units because you no longer need to have user 
ASPs on your system and you want to move all the disk units back to the system 
ASP. 


Note: Disk units cannot be moved to or from an independent auxiliary storage 
pool. 


Restrictions When Changing Your ASP Configuration: Consider these things when 
you are planning to move disk units from an ASP: 


* The system may take a long time to move the unit because it must copy the data 
from that unit to other units in the ASP. 


* You cannot move unit 1 (the load source unit) from the system ASP. 
* You cannot move disk units from a user ASP that is overflowed. 
* You cannot move units in and out of the same ASP in the same operation. 
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* When mirrored protection is active for an ASP, you cannot move disk units in 
and out of the ASP. You must remove disk units in pairs from a mirrored ASP. 
You can then add them to a different ASP. 


* When mirrored protection is active for the ASP that contains the disk units, you 
must remove both units of a mirrored pair. 


* When you remove a disk unit, it becomes nonconfigured. 
To move disk units between ASPs, do the following: 
1. If you are not already using DST, perform a manual IPL to start DST. See 
2. From the Use Dedicated Service Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 
b. Select option 1 (Work with disk configuration) on the Work with Disk 
Units display. 
c. Select option 3 (Work with ASP configuration) on the Work with Disk 
Configuration display. 


3. Select option 6 (Move units from one ASP to another) from the Work with 
ASP Configuration display. The Specify ASP to Move Disk Units display is 


shown. 
( Specify ASP to Move Disk Units ) 
To move units to different ASPs, specify the ASP that you want to move each 
one to in the 'New ASP' field. Specify the units to be moved, press Enter. 
New Current Serial --Protected-- --Unprotected-- 
ASP ASP Unit Number Type Model Size %Used Size  %Used 
1 0 0.00% 4124 41.50% 
1 @0-0193825 6602 030 0 0.00% 1031 82.00% 
2 00-0163477 6602 030 0 0.00% 1031 29.00% 
2 3 00-0190494 6602 030 0 0.00% 1031 27.00% 
2 4 00-17900 6602 030 0 0.00% 1031 28.00% 
2 


4. Type the number of the ASP you want to move the units to in the New ASP 
column and press the Enter key. If you specify an ASP that does not 
currently exist on your system, the system creates a new ASP. If the move 
operation would leave the source ASP with insufficient storage, you receive 
an error message. 


If you see the Confirm Move of Unit display, skip to step (6| 


The Confirm Continuation display is shown if the storage management 
directories are not usable: 


Confirm Continuation 
In order to proceed the system must perform internal processing that may 
take several minutes during which the system may appear inactive. Press 
Enter to continue. Press F12=Cancel to return and change your choice. 


5. Determine whether you want to cancel the procedure or continue. If you 
want to continue, press the Enter key. 


6. The Confirm Move of Unit display is shown: 
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(— * 


Confirm Move of Unit 
Moving units will take several minutes. Press Enter to confirm your 
choice to move the units. Press F9=Capacity information to display the capacity. 
Press Fl2=Cancel to return to change your choice. 


Serial --Protected-- --Unprotected-- 
ASP Unit Number Type Model Size Used Size %Used 
1 0 0.00% 2062 83.00% 


1 00-0193825 6602 030 
2 00-0163477 6602 030 
2 0 0.00% 2062 30.01% 
3 00-0190494 6602 030 
4 00-17900 6602 030 


Press F9 (Capacity information) to display the resulting capacity. 


fo Resulting Capacity ) 


The configuration change that you requested would result in the following 
ASP capacities. Press Enter to continue. 


woncn------ Current----------  ----------Propose----------- 

--Protected-- -Unprotected- --Protected-- -Unprotected- 

ASP Threshold Size %Used Size %Used Size Used Size ‘%Used 
1 90% 0 0.00% 4124 41.50% 0 0.00% 2062 83.00% 
2 90% 0 0.00% 2062 0.01% 


Ne 


7. Press the Enter key to return to the Confirm Move of Unit display. 

8. Press the Enter key on the Confirm Move of Units display to move the 
selected units. The system will move the data off the selected units to the 
remaining units in the source ASP. The move can take several minutes 
during which the system appears inactive. 

9. When the move operation is complete, you return to the Work with ASP 
Configuration display. 


10. If you have no other tasks to perform, end DST. (See [How to Stop| 
Dedicated Service Tools (DST)” on page 396}) 


How to Remove a Disk Unit from an Auxiliary Storage Pool 


Use the procedure for removing disk units from your system for the following 
reasons: 


* You want to physically remove a disk unit from your system. 


* You want to move a disk unit from an ASP that has mirrored protection to 
another ASP. You can remove pairs of disk units from a mirrored ASP without 
stopping mirrored protection. You then add the disk units to the target ASP. 


Considerations When Changing Your ASP Configuration: Consider these things 
when you are planning to remove disk units from an ASP: 


* The system may take a long time to remove the unit because it must copy the 
data from that unit to other units in the ASP. 


* To proceed, the system must perform internal processing that may take several 
minutes during which the system may appear inactive. 


* When you remove a disk unit, it becomes nonconfigured. 


Restrictions When Changing Your ASP Configuration: Consider these restrictions 
when you are planning to remove disk units from an ASP: 
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* You cannot remove unit 1 (the load source unit) from the system ASP. 
* You cannot remove disk units from a user ASP that is overflowed. 


* When mirrored protection is active for the ASP that contains the disk units, you 
must remove both units of a mirrored pair. 


* If you are going to physically remove a disk unit from an IOA, you must either 
exclude the disk unit or stop device parity protection first. 


To remove a disk unit, do the following: 
1. If you are not already using DST, perform a manual IPL to start DST. See|How] 
2. From the Use Dedicated Service Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 
b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 
c. Select option 3 (Work with ASP configuration) on the Work with Disk 
Configuration display. 
3. You are shown the Remove Units from Configuration display. 


( Remove Units from Configuration . 
Type options, press Enter. 
4=Remove unit from configuration 
Serial Resource 
OPT Unit ASP Number Type Model Name Status 
2 1 10-00A7529 9332 400 DDO10 Configured 
3 tk 10-00A4936 9332 400 DDO12 Configured 
4 1 10-00A4936 9332 400 DDO19 Configured 
4 5 1 10-00A7498 9332 400 DDO25 Configured 
4 6 L 10-00A7498 9332 400 DDO36 Configured 
ih 1 10-00A7530 9332 400 DD042 Configured 
a 8 iL 10-00A7530 9332 400 DDO52 Configured y 


4. Type a 4 (Remove unit from configuration) in the OPT column for each unit that 
you want to remove and press the Enter key. If the remove operation would 
leave the ASP with insufficient storage, you receive an error message. 

If you see the Confirm Remove Disk Units display, skip to|4 
The Confirm Continuation display may be shown before the Confirm Remove 
Disk Units display if the storage management directories are not usable. 


Confirm Continuation 


To proceed, the system must perform internal processing 
that may take several minutes during which the system may 
appear inactive. 


Press Enter to continue. 
Press Fl2=Cancel to return and change your choice. 


5. Determine whether you want to cancel the procedure or continue. If you want 
to continue, press the Enter key. 


6. The Confirm Remove Disk Units display is shown: 
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Confirm Remove Disk Units 
Removing disk units will take several minutes. 
Press Enter to confirm remove of disk units. 


Press F9=Capacity information to display the capacity information. 
Press Fl2=Cancel to return to change your choice. 


Serial Resource 
OPT Unit ASP Number Type Model Name Status 
4 5 1 = 10-00A7498 9332 400 DDO10 Configured 
ee 6 1 = 10-00A7498 9332 400 DDO12 Configured y 


Press F9 (Capacity information to display the resulting capacity. 


Ve 
Resulting Capacity . 


The configuration change that you requested would result in the 
following ASP capacities. 


Press Enter to continue. 


weennn----- Current----------  ----------Modified-------- 

--Protected-- -Unprotected- --Protected-- -Unprotected- 

ASP Threshold Size “Used Size %Used Size %Used Size Used 
Os 90% 0 0.00% 1600 52.70% 0 0.00% 1200 70.26% ) 


7. Press the Enter key to return to the Confirm Remove Disk Units display. 


8. Press the Enter key on the Confirm Remove Disk Units display to remove the 
selected units. The system moves the data off the units selected to be removed 
to the remaining units in the source ASP. The remove can take several minutes 
or several hours during which the system appears inactive. 


Notes: 


a. The time it takes to remove a unit depends on the disk unit type and 
model. 


b. If the data on the unit being removed is severely fragmented and the 
amount of storage used is high, the remove operation could take several 
hours. 


9. When the remove operation is complete, you return to the Work with ASP 
Configuration display. 


If you have no other tasks to perform, end DST. (See |“How to Stop Dedicated 
Service Tools (DST)” on page 396 


) 


How to Delete an Auxiliary Storage Pool 


When you delete a user ASP, the status of all the units that are assigned to the ASP 
becomes nonconfigured. Any data that is in the ASP is deleted. The normal 
procedure is to remove all objects from the ASP before you delete the ASP. You can 
do this either by moving the objects to a different ASP or by deleting the objects. If 
you delete an ASP that has objects in it, those objects are marked by the system as 
damaged or destroyed. 


You cannot delete ASP 1, which is the system ASP and holds the operating system. 


To delete a user ASP, do the following: 
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1. If you are not already using DST, perform a manual IPL to start DST. See[“How| 
2. From the Use Dedicated Service Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 
b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 
c. Select option 3 (Work with ASP configuration) on the Work with Disk 
Configuration display. 


3. Select option 2 (Delete user ASP) on the Work with ASP Configuration display 
and press the Enter key. 


Delete User ASP 
Type option, press Enter 4=Delete 


--Protected-- --Unprotected-- 
Option ASP Threshold Overflow Size %Used Size Used 
1 90% No 600 77.84% 0 0.00% 
2 90% No 0 0.00% 200 0.53% 
3 90% No 0 0.00% 200 0.53% 


4. Type a 4 in the Option field of the ASP you want to delete and press the Enter 
key. The Confirm Delete of User ASP display is shown. 


Confirm Delete Of User ASP 
Warning: Deleting a user ASP will remove all units of that ASP from the 
configuration. The units will become nonconfigured. Press F1@ to confirm 
your choice for 4=delete Press F12=Cancel to return to change your choice 


--Protected-- --Unprotected-- 
Option ASP Threshold Overflow Size %Used Size %Used 
4 2 90% No 0 0.00% 200 0.53% 


5. Press F10 (Confirm) to confirm that delete of the ASP. The delete operation may 
take several minutes. 


6. If you have no other tasks to perform, end DST. (See |“How to Stop Dedicated| 
Service Tools (DST)” on page 396}) 


Calculating Space Requirements for an Auxiliary Storage Pool 


When you are planning to make changes to the disk configuration or disk 
protection on your system, you need to calculate the space requirements for the 
change before you begin. You want to ensure that your system has sufficient disk 
storage for the changes. Use the disk space calculator available in the Systems 
Management topic of the iSeries Information Center at 

http:/ /www.ibm.com/eserver /iseries /infocenter. 


How to Display the Objects in a User ASP 


To print a list of all the objects in a nonlibrary user ASP, use the DSPOBJD 
command. Specify object types *SAVF, *JRN, and *JRNRCV. The object description 
information includes the ASP where the object is located. 


To list all the documents in a user ASP, use the Query Document Library 
(QRYDOCLIB) command: 


QRYDOCLIB ... QRYDFN(*IF(*ASP *EQ 4)) 
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To determine which ASP an object is in, use the DSPOBJD command and look at 
the number shown on the Auxiliary storage pool field. To determine which ASP a 
DLO is in, use the DSPDLONAM command. Look at the number shown on the 
Auxiliary storage pool field. 


If the object is an IFS object, use the Display Object Links (DSPLNK) command. 
Select option 8 (Display attributes) to determine which ASP the object is in. 


Balancing an Auxiliary Storage Pool 


Beginning with V4R4MO0, you can use the ASP balancing function. This function 
improves system performance by balancing disk utilization across all of the disk 
arms in an ASP. You can use the Start ASP Balance® (STRASPBAL) command to 
start the function. You will need to select the method of balancing that you wish to 
use: 

* Capacity balancing 

* Usage balancing 

* Hierarchical Storage Management (HSM) balancing 


Note: You cannot balance journal receivers among the disk units of an ASP if the 
journal does not have one of the receiver size options specified. If neither 
*MAXOPT1 nor *MAXOPT2 are specified for the RCVSIZOPT parameter on 
CRIJRN or CHGJRN, then the journal receiver can only be spread across 10 
disk arms. If either *MAXOPT1 or *MAXOPT2 is specified, then the journal 
receiver can be spread across as many as 100 arms. Using 
RCVSIZOPT(*RMVINTENT) will also effect how the journal receiver uses 
the disk arms in the ASP. 


Before using usage balancing or HSM balancing, you must run the Trace ASP 
Balance (TRCASPBAL) command. This command starts a trace function that 
collects statistics on the data in the ASPs that you wish to balance. Data that is 
used often is referred to as high use or hot data. Data that is not used often is 
referred to as low use or cold data. 


To end the ASP balancing function, use the End ASP Balance (ENDASPBAL) 
command. 


Capacity Balancing 


When you use capacity balancing, the data on the disk units within an ASP is 
distributed evenly across all the units. Instead of some units containing the 
majority of the data, each unit has an equal percentage of used and unused space. 
This type of balancing is useful when you add new disk units to an ASP. 


Usage Balancing 
Usage balancing is useful when the ASP contains some disk units which are 
utilized to a higher degree than other disk units in the ASP. The TRCASPBAL 
command must finish collecting statistics before usage balancing can begin. When 
you use usage balancing, the high use and low use data on each unit in the ASP is 
redistributed to balance the arm utilization of each unit within the specified ASP. 


Hierarchical Storage Management (HSM) Balancing 


Hierarchical Storage Management balancing can only be used ASPs that contain a 
mixture of compressed and non-compressed disk units. The TRCASPBAL 
command must finish collecting statistics before hierarchical storage management 
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balancing can begin. When you use hierarchical storage management balancing, 
the high use and low use data on each unit in the ASP is redistributed. The high 
use data is moved to high performance units and the low use data is moved to 
low performance units. After the balance activity has completed, the system clears 
the trace information. 


Transferring Objects between Auxiliary Storage Pools 


This topic explains how to move entire libraries or folders from one ASP to 
another ASP. It also describes special procedures when you are moving a library 
that contains journals because a journal and the journaled objects must be in the 
same basic user ASP or the same independent ASP group. 
[Nonlibrary User ASPs” on page 423] discusses the procedures for working with 


nonlibrary user ASPs. 


You cannot directly move objects between ASPs because the MOVOBJ command 

and the MOVDOC command move only the pointer to the object. They do not 

physically copy data from one location to another. In general, do the following to 

move an object to a different ASP: 

1. Save the object. 

2. Delete the object from the system. If you are transferring the object from one 
independent ASP to another independent ASP, this step is not required. 

3. Restore the object to the target ASP by using the RSTASP parameter on the 
RSTxxx command. If you are restoring objects to an independent ASP, use the 
RSTASPDEV parameter. 


These restrictions apply when specifying the RSTASP parameter for a basic user 

ASP: 

* When you attempt to restore an object to a different basic ASP from its library, 
the ASP must be a nonlibrary user ASP and the object must be a journal, a 
journal receiver, or a save file. 

— For journals, journal receivers, and save files, if a library exists on the ASP, 
you receive an error message and the object is not restored. 

— For other object types, the object is restored to the ASP that contains the 
library. 


* If you try to restore an object to a basic user ASP by explicitly specifying the 
desired user ASP for the RSTASP parameter and the designated user ASP does 
not exist, you receive a message. The object is not restored. 


* If you restore an object and specify RSTASP(*SAVASP), and if the basic ASP 
from which the object was saved no longer exists, the object is restored to the 
system ASP. You receive an informational message. 


If you try to restore an object to an independent ASP by explicitly specifying the 
desired independent ASP for the RSTASPDEV parameter and the designated 
independent ASP does not exist, you receive a message. The object is not restored. 


How to Move Authorities to a Different ASP 


Because you must delete an object in order to move it to another ASP, private 
authorities to the object are lost. To move authorities for an object, do the 
following: 


1. Sign on as QSECOFR. 
2. Copy the object’s authorities to a temporary object. 
a. Create a temporary object: 
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CRTDTAARA QTEMP/X *CHAR AUT (*EXCLUDE) 
b. Copy the authorities: 


RVKOBJAUT QTEMP/X *DTAARA QSECOFR *ALL 
GRTOBJAUT OBJ(QTEMP/X) OBUJTYPE(*DTAARA) 
REFOBJ (object) 
REFOBJTYPE (object-type) 


Save the object to your save media. 

Delete the object from the system. 

Restore the object to the target ASP. 

Copy the authorities to the restored object. 


GRTOBJAUT OBJ(object) OBJTYPE(object-type) 
REFOBJ (QTEMP/X) 
REFOBJTYPE (*DTAARA) 


7. Delete the temporary object: 
DLTDTAARA QTEMP/X 


oo & & 


How to Transfer a Library to a Different ASP 


Use the following procedure to move a library to a different ASP. This example 
moves the CUSTLIB library from ASP 1 to ASP 2. 


1. Save the private authorities for the library: SAVSECDTA DEV(TAPO1). 


2. Save the library: SAVLIB LIB(CUSTLIB) DEV(TAPQ1) ACCPTH(*YES). Consider 
saving the object twice to 2 different media volumes. 


3. Delete the library: DLTLIB LIB(CUSTLIB). 
4. Place the system in a restricted state: ENDSBS *ALL *IMMED. 


5. Restore the information about private authorities that you saved along with 
user profiles in step [1] RSTUSRPRF USRPRF(*ALL) DEV(TAPO1) 

6. Restore the library to the new user ASP: RSTLIB SAVLIB(CUSTLIB) RSTASP(2) 

7. Restore authority to the library and its objects: RSTAUT 


How to Transfer a Folder to a Different ASP 
Use the following procedure to move a folder to a different ASP. This example 
moves the HRFLR folder from ASP 1 to ASP 2. Do not move IBM-supplied folders 
(those starting with Q) to a user ASP. These folders must be in the system ASP. 
1. Save the private authorities for the folder: SAVSECDTA DEV(TAP@1). 
2. Save the folder: SAVDLO DLO(*ALL) FLR(HRFLR) DEV(TAPO1). Consider saving the 
object twice to 2 different media volumes. 


3. Delete the folder: DLTDLO DLO(*ALL) FLR(HRFLR). Do not skip this step. If you 
restore a DLO to an ASP and it already exists in another ASP, you receive an 
error message. The restore operation continues with the next DLO. If you issue 
a restore command for a large number of DLOs, you will receive a large 
number of error messages. 

4. Place the system in a restricted state: ENDSBS *ALL *IMMED. 


5. Restore the private authorities you saved in step {1} RSTUSRPRF USRPRF (*ALL) 
DEV(TAPO1) 


6. Restore the folder to the new user ASP: RSTDLO DLO(*ALL) SAVFLR(HRFLR) 
RSTASP(2) 


7. Restore authority to the folder and its objects: RSTAUT 
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You can move more than one folder at a time by specifying multiple folders on the 
SAVDLO and RSTDLO commands. If you save DLOs from more than one ASP, 
you must specify sequence numbers on the RSTDLO command. 


How to Transfer Journals and Objects to a Different ASP 


If you use a library user ASP, both the objects you are journaling and the journal 
must be in the same ASP. For the purpose of recovery as well as performance, it is 
recommended that the journal receiver be placed in a different user ASP. If the 
journal is in the system or a basic user ASP, place the journal receiver in another 
basic user ASP. If the journal is in an independent ASP, place the journal receiver 
in secondary ASP when the journal is stored in the primary ASP of the disk pool 
group. If a failure occurs in the ASP that contains the objects and the journal, you 
do not lose both the objects and the journaled changes that are in the receiver. 
Placing your objects and journal receiver in the same user ASP also causes 
contention between access to the object and access to the journal receiver. 


Use the following procedure to move a journal and the associated journaled objects 
to a different ASP. This procedure applies to library user ASPs (where the journal 
and _ its library are in the same ASP). If the journal is in a nonlibrary user ASP, refer 
to |“How to Work with Nonlibrary User ASPs” on page 423 


Transferring journaled objects 


1. Save private authorities for the journal and journaled objects: SAVSECDTA 
DEV (TAPO1) 


2. Save the journal using the SAV, SAVOBJ or the SAVLIB command. 


3. Because the journal and journaled objects must be in the same ASP, the objects 
must also be moved to the same user ASP before you can resume journaling 
the objects after the move. 

4. Save any objects that you journal and save any logical files that have their 

access paths journaled. You can use the Work with Journal Attributes 

command to determine which objects that you journal. Consider saving the 
journal and journaled objects twice to two different media volumes. 

Delete the journaled objects using the appropriate delete command. 

. Delete the journal using the Delete Journal (DLTJRN) command. 


. Delete the library that contained the journal. 


ON an 


. Create the library for the journal in the user ASP using the Create Library 
(CRTLIB) command: 


* For basic ASPs specify: 
CRTLIB LIB(library-name) ASP(asp-number) 
* For independent ASPs specify: 
CRTLIB LIB(library-name) ASP(*ASPDEV) ASPDEV(asp-device-name) 


Note: The new library must have the same name as the library in which the 
journal was originally located. 


9. Place the system in a restricted state: ENDSBS *ALL *IMMED 
10. Restore the user profiles you saved in step|I} 
RSTUSRPRF USRPRF(*ALL) DEV(TAPO1) 


11. Restore the journal to the library in the user ASP using the Restore Object 
(RSTOBJ) command. For independent ASPs, specify the RSTASPDEV 
parameter. 
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12. Restore the previously journaled objects to the library or directory in the user 
ASP. If you want to restore the previously journaled objects to their original 
libraries or directories, you must first move those libraries or directories to the 
user ASP. You move libraries and directories to a different ASP by saving 
them, deleting them, and restoring them to the new ASP. 


Restoring the previously journaled objects automatically resumes journaling 
for the objects if the journal already exists. 


13. Restore the private authorities you saved in step 
RSTAUT 

14. Save the journaled objects so that the journaled changes can be applied, if 
necessary. When journaling starts, the system assigns a journal identifier (JID) 
to the object. Usually the JID that is assigned is the same JID that the object 
had when it was saved. The object must be saved after the JID is assigned. 


How to Create Objects in a Library User ASP 


You create an object in a specific ASP by placing it in a library or folder that is in 
the ASP. You place a library or a folder in an ASP in one of the following ways: 


* Specify a value for the ASP parameter on either the CRTLIB command or the 
CRTFLR command. The default for the ASP parameter is 1. 


* Restore the library or the folder to a specific ASP by using the RSTASP 
parameter on the restore command. 


IFS objects can reside in a user ASP through the use of User-defined file systems 

(UDFS) by doing the following: 

1. Create a user defined file system in the ASP. 

2. Mount the UDFS over another directory and use it through the mounted-over 
path. 

For more information about User-defined files sytems, see the Information Center 

at the following Web site: 


http://www. ibm.com/eserver/iseries/infocenter 


Placing a Document in a Basic ASP—Example 
The following is an example of placing a document in a specific basic ASP: 


1. To create a folder in a basic ASP, use the ASP parameter on the CRTFLR 
command: 


CRTFLR FLR(ASP3FLR) ASP(3) 


2. To create a document in that folder, use the CRTDOC command or a program 
that creates documents. 


When you create a document or another folder in ASP3FLR, the new document or 
folder is automatically placed in ASP 3. 


When you create the first folder in a basic ASP, the system creates the 
corresponding library. For example, when you create the ASP3FLR folder, the 
system creates the QDOC0003 library if it does not already exist. You should never 
create a QDOCnnnn library yourself. This can cause unpredictable results. 


Placing an Object in a User ASP—Example 


The following is an example of placing a journal receiver in a specific user ASP: 
1. Create a library for the journal receiver: 
* For basic ASPs, specify: 
CRTLIB LIB(ASP2LIB) ASP(2) 
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* For independent ASPs, specify: 
CRTLIB LIB(library name) ASP(*ASPDEV) ASPDEV(asp-dev-name) 


2. If the journal receiver is being place in an independent ASP, use the Set ASP 
Group(SETASPGRP) command to associate the job with the correct independent 
ASP. 

3. Create the journal receiver in the library that you created in the user ASP: 
CRTJRNRCV JRNRCV(ASP2LIB/RCVINASP2) 


Creating a UDFS in User ASP—Example 

The following is an example of creating a UDFS in a user ASP using the Create 
User-Defined File System (CRTUDFS) command and the Add Mounted File System 
(MOUNT) command. 


1. Create a user-defined file system in ASP 2. All objects created in this new file 
system will also reside in ASP 2: 


CRTUDFS UDFS('/dev/qasp02/asp2dir.udfs') 
2. Mount the user-defined file system over directory ’/myLocalPath’: 

MOUNT TYPE(*UDFS) MFS('/dev/qasp02/asp2dir.udfs') MNTOVRDIR('/myLocalPath') 
3. Create a directory in the user-defined file system: 

CRTDIR DIR('/myLocalPath/newDir') 


How to Place Journal Receivers in a User ASP 


Placing journal receivers in a user ASP may improve your system performance. 
Dedicating a user ASP to the journal receivers for a single journal is the 
recommended approach. Placing journal receivers in a library user ASP simplifies 
recovery. Following are the procedures for placing journal receivers in both a 
library user ASP and a nonlibrary user ASP. 


Placing Journal Receivers in a Library User ASP 

The following procedure uses the example of the CUSTJRN journal and journal 

receivers that use the naming convention CUSTRnnnn. 

1. Create a library for the journal receiver in the desired user ASP: 

* For a basic ASP, specify: 
CRTLIB LIB(CUSTJRNR) ASP(4) 
* For an independent ASP, specify: 
CRTLIB LIB(CUSTJRNR) ASP(*ASPDEV) ASPDEV(asp-dev-name) 

2. Use the WRKJRNA command to find the name of the currently attached journal 
receiver: WRKJRNA JRN(CUSTJRNR/CUSTJRN). For the example, assume the 
currently attached journal receiver is CUSTRO005. 

3. Use F17 (Display attributes) to determine the attributes for the current receiver. 

4. If the journal receiver is being place in an independent ASP, use the Set ASP 


Group(SETASPGRP) command to associate the job with the correct independent 
ASP. 


5. Create a new journal receiver in the library that is in the user ASP. Use a name 
that continues your naming convention. Specify the attributes that you 
displayed. For example, if the threshold of the current receiver is 100000, you 
would specify the following: 

CRTJRNRCV JRNRCV(CUSTJRNR/CUSTROO06) THRESHOLD (100000) 

6. Change journal receivers so the new journal receiver is attached and actively 

receiving journal entries: 
CHGJRN JRN(CUSTJRN) JRNRCV(CUSTJRNR/CUSTROOO6) 
7. You can save the detached journal receiver and delete it from the system. 
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8. In the future, when you change journal receivers and specify JRNRCV(*GEN), the 


system will create the new journal receiver in the CUSTJRNR library in ASP 4. 


How to Move Journal Receivers From an Overflowed Basic 
User ASP 


To maintain journaling for the objects, do the following steps: 


1. 


Use the WRKJRNA command to determine the names of the journal receivers 
associated with the journal: WRKJRNA JRN(library-name/journal-name ) 


Use F17 to display the attributes of the receiver that is attached. 


If the journal receiver to be moved is attached to a journal, create a new journal 
receiver on a different ASP by using the CRTJRNRCV command. Assume the 
currently attached receiver is CUSTRO005. Use a name for the journal receiver 
that continues your naming conventions. 


If the journal receiver is in a library user ASP, do the following: 


a. Create a new library in a different ASP, such as LIBJNEW: CRTLIB 
LIB(LIBJNEW) ASP(4) 


b. Create a new journal receiver in the library. Specify the attributes that you 
displayed. For example, if the threshold of the current receiver is 100000, 
you would specify the following: 


CRTJRNRCV JRNRCV(LIBUNEW/CUSTROQ06) THRESHOLD (100000) 


If the journal receiver is in a nonlibrary user ASP, create a new journal receiver 
in a different nonlibrary user ASP or in the system ASP: CRTJRNRCV 
JRNRCV (CUSTUJRNR/CUSTROO06) ASP(5) 


Change the journal by using the Change Journal (CHGJRN) command. Specify 
the newly created journal receiver on the JRNRCV parameter: CHGJRN 
JRN(CUSTJRNR/CUSTJRN) JRNRCV(library-name/CUSTRO006) 


Save the journal receivers from the overflowed user ASP. If the journal receivers 
are the only objects in the library, use the Save Library (SAVLIB) command. If 
other objects are in the library, use the Save Object (GAVOBJ) command. 


If you used the SAVLIB command in step |5} delete the library from the 
overflowed user ASP by using the DLTLIB command. If you used the SAVOBJ 
command, delete the journal receivers using the DLTJRNRCV command. 


Journal receivers can be restored only to the library from which they were 
saved. The steps required to restore these journal receivers if you need them for 
a recovery depend on whether they were in a library user ASP or a nonlibrary 
user ASP. For journal receivers in a nonlibrary user ASP, you can restore them 
to any ASP, as long as their library is in the system ASP. For libraries that were 
in a library user ASP, you must ensure that the ASP has adequate space before 
restoring the journal receivers to the library. 


How to Reset a Journal with a Status of Overflowed 


If a journaled object has a status of overflowed, you must delete it and restore it to 
reset its status. 


Note: Use the DSPOBJD command to determine whether a specific object in a 


library has a status of overflowed. Use the DSPLNK command and select 
option 8 to determine whether a specific object in a directory has a status of 
overflowed. 
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Because journals and journaled objects must be in the same ASP, the best method 
for dealing with an overflowed journal is to restore it to the same basic ASP. If you 
restore the journal to a different ASP, you must also move all the journaled objects 
to that ASP. 


This topic describes the procedure for restoring a journal to the same ASP to reset 
its overflowed status. If you want to move the journal and journaled objects to_a 
different-ASP follow tie procedure inf Haw ta Transfer Journal and Objectsito a 


Before beginning this procedure, ensure that you have freed enough space in the 
overflowed ASP to prevent the journal from overflowing when it is restored. 


1. Use the WRKJRNA command to print information about journaled objects and 
the receiver directory: WRKJRNA JRN(library-name/journal-name ) 
OUTPUT (*PRINT). 


2. Use the SAVOBJ command to save the journal that must be reset. 


3. Save the journal receivers that are associated with the journal by using the Save 
Object (SAVOBJ) command. 


4. End journaling for any objects being journaled as follows 
a. Access paths: 
ENDJRNAP JRN(library-name/journal-name) FILE(*ALL) 
b. Physical database files: 
ENDJRNPF JRN(Library-name/journal-name) FILE(*ALL) 
c. IFS objects: 
ENDJRN OBJ(*ALL) JRN('QSYS.LIB/library-name.LIB/journal-name.JRN') 
d. All other object types: 
ENDJRNOBJ OBJ(*ALL) OBJTYPE(*ALL) JRN(library-name/journal-name) 
5. Delete the journal: DLTJRN JRN(library-name/journal-name). 


6. Restore the journal to the same library and the same ASP. If the journal was in 
library user ASP, you do not need to specify the ASP parameter on the RSTOBJ 
command. If the journal was in a nonlibrary user ASP, specify RSTASP (*SAVASP) 
on the RSTOBJ parameter. 


7. Start journaling again for each object that was journaled as follows: 
a. Database physical files: 
STRJRNPF FILE(library-name/file-name) JRN(library-name/journal-name) 
b. Access paths: 
STRJRNAP FILE(library-name/file-name) JRN(library-name/journal-name) 
c. IFS objects: 


STRJRN OBJ('object-path-name ' ) 
JRN('/QSYS.LIB/library-name.LIB/journal-name.JRN') 


d. All other object types: 


STRJRNOBJ OBJ(library-name/file-name) OBJTYPE(object-type) 
JRN(Library-name/journal-name) 


You printed a list of objects in step 
8. Reestablish the journal receiver chain. Do the following: 
a. Type WRKJRN and press the Enter key. 
b. On the prompt display, type the name of the journal and the library. 


c. On the Work with Journals display, select option 9 (Associate receivers with 
journal). 
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d. When you receive a message that the receivers have been associated, press 
F12 to return. 

e. Type the following: 

WRKJRNA JRN(Library-name/journal-name) 

f. On the Work with Journal Attributes display, press F15 to display the 
receiver directory. If the receiver chain is not correct, do the following. This 
is most likely to be required if any journal receivers were created before 
V3R1. 

1) Delete all the journal receivers from the system, using the DLTOBJ 
command. 

2) Restore the journal receivers from the newest to oldest. This associates 
them with the journal and builds the receiver chain in the correct 
sequence. 

9. Use the DSPOBJD command to display the object description for the journal. 

Ensure that the journal is no longer in overflowed status. 


How to Work with Nonlibrary User ASPs 


This topic describes the procedures for working with objects in a nonlibrary user 
ASP. The object types that are allowed in a nonlibrary user ASP are: 


* Journal 
¢ Journal receiver 
° Save file 


Creating Objects in a Nonlibrary User ASP 


You can create journals, journal receivers, and save files in nonlibrary user ASPs. 
When you create an object in a nonlibrary user ASP, the library for the object must 
exist in the system ASP. For example, to create a save file in a nonlibrary user ASP, 
do the following: 


CRTSAVF FILE(SAVFLIB/DSTSAV) ASP(4) 


where 4 is the number of the user ASP where you are placing the save file. The 
library for the save file is in the system ASP and ASP 4 does not contain any 
libraries. 


After the object is created, all storage for the object resides in the designated user 
ASP. Changes and additions to that object are also made in the user ASP. If the 


ASP becomes full, it overflows into the system ASP.|Chapter 20, “Working with 
Auxiliary Storage Pools” on page 403] describes how to reset an overflowed 


auxiliary storage pool. 


It is recommended that all journals and journal receivers on the system have 
unique names. RCLSTG renames them if duplicate names are found when objects 
are placed in library QRCL and the user cannot rename them to their original 
name. 


Monitor the size of objects to prevent them from overflowing into the system ASP 
with the MAXRCDS parameter on the CRTSAVF command, and the THRESHOLD 
parameter on the CRTJRNRCV command. 


Transferring an Object to a Nonlibrary User ASP 


The following procedure shows an example of moving an object to a nonlibrary 
user ASP. In the example, the DSTSAVF save file is moved to ASP 4. The library 
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(SAVFLIB) for the DSTSAVF is in the system ASP. You can use this procedure only 
for save files, journals, and journal receivers. 


1. Display private authorities for the save file: DSPOBJAUT OBJ (SAVFLIB/DSTSAVF) 
OBJTYPE(*SAVF) OUTPUT (*PRINT) 


2. Save the save file: SAVOBJ OBJ(SAVFLIB/DSTSAVF) OBJTYPE(*SAVF) DEV(TAPO1) 


Note: If you want to save the data in the save file, specify SAVFDTA(*YES). 
3. Delete the save file: DLTSAVF SAVF(SAVFLIB/DSTSAVF) 
4. Restore the save file to ASP 4: RSTOBJ OBJ (SAVFLIB/DSTSAVF) RSTASP(4) 


5. Use the Edit Object Authority (EDTOBJAUT) command to reestablish the 
private authorities you printed in step 


Transferring a Journal to a Nonlibrary User ASP 

Use the following procedure to move a journal to a different nonlibrary basic user 

ASP and to reassociate any previously journaled objects with that journal. 

1. Sign on as QSECOFR. 

2. Save the journal with either the SAV, SAVOBJ, or SAVLIB command. 

3. List the objects being journaled: WRKJRNA JRN(library-name/journal-name) 
OUTPUT (*PRINT) 

4. Copy private authorities for the journal to a temporary object. 
a. Create a temporary object: 


CRTDTAARA DTAARA (QTEMP/X) 
TYPE (*CHAR) 
AUT (*EXCLUDE) 


b. Make sure that there are no authorities to the temporary object: 


RVKOBJAUT OBJ(QTEMP/X) OBJTYPE(*DTAARA) 
USER(QSECOFR) AUT(*ALL) 


c. Copy the authorities from the journal to the temporary object: 


GRTOBJAUT OBJ(QTEMP/X) OBJTYPE(*DTAARA) 
REFOBJ(library-name/journal-name) 
REFOBJTYPE (*JRN) 


5. Stop journaling access paths for the journal: ENDJRNAP FILE(*ALL) 
JRN(library-name/journal-name) 

6. Stop journaling physical files for the journal: ENDJRNPF FILE(*ALL) 
JRN(library-name/journal-name) 

7. Stop journaling IFS objects: ENDJRN OBJ(*ALL) JRN('/QSYS.LIB/library- 

name. LIB/journal-name.JRN'/) 

8. Stop journaling all other object types for the journal: ENDJRNOBJ OBJ (*ALL) 

OBJTYPE(*ALL) JRN(library-name/journal-name) 

9. Delete the journal with the DLTJRN command. 

10. Restore the journal to the user ASP: RSTOBJ OBJ (journal-name) OBJTYPE(*JRN) 
RSTASP (asp-number) 

11. Use the STRJRNPF, STRJRNAP, STRJRNOBJ, and STRJRN commands to 
resume journaling for any previously journaled objects. Refer to the list you 
printed in step 

12. Reestablish private authorities to the journal. 

a. Copy authorities from the temporary object to the journal. 


GRTOBJ OBJ(library-name/journal-name) 
OBJTYPE(*JRN) REFOBJ(QTEMP/X) 
REFOBJTYPE (*DTAARA) 
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b. Delete the temporary object. DLTDTAARA QTEMP/X 


Placing Journal Receivers in a Nonlibrary Basic ASP 

The following procedure also uses the example of the CUSTJRN journal and 
journal receivers that use the naming convention CUSTRnnnn. This example 
assumes that the library for the journal receiver (CUSTJRNR) already exists in the 
system ASP. 


1. Use the WRKJRNA command to find the name of the currently attached journal 
receiver: WRKJRNA JRN(CUSTJRNR/CUSTJRN). For the example, assume that the 
currently attached journal receiver is CUSTRO005. 

2. Use the Display Journal Receivers Attributes (DSPJRNRCVA) command to 
determine the attributes for the current receiver: DSPURNRCVA 
JRNRCV (CUSTURNR/CUSTROOO5) 

3. Create a new journal receiver in a user ASP. Use a name that continues your 
naming convention. Specify the attributes that you displayed, such as the 
threshold: 


CRTJRNRCV JRNRCV(CUSTJRNR/CUSTROQ06) ASP(4) 
THRESHOLD (100000) 


4. Change journal receivers so the new journal receiver is attached and actively 
receiving journal entries: 


CHGJRN JRN(CUSTJRN) JRNRCV (CUSTJRNR/CUSTROO06) 
5. You can save the detached journal receiver and delete it from the system. 


6. In the future, when you change journal receivers and specify JRNRCV(*GEN), the 
system will create the new journal receiver in the CUSTJRNR library in ASP 4. 
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Chapter 21. Working with Device Parity Protection 


This chapter describes procedures for working with device parity protection on 
your system. When you are making changes to the disk configuration or disk 


protection_on your system, you need to perform tasks in the correct sequence. 
Refer to|“Choosing the Right Procedure for Configuring Disks” on page 383] to 


determine the correct tasks for your situation. 


Starting Device Parity Protection 


Usually, you start device parity protection when you attach a new disk subsystem 
to your system. Ideally, you should start device parity protection before you add 
the disk units to the software disk configuration. When you start device parity 
protection for disk units that are already being used, the system must move data 
off of the disk units to other disk units in the ASP in order to make space available 
for the parity data. The performance for starting device parity protection is much 
better if the system does not have to move data. 


When you start device parity protection, the system does validity checking and 
moves data from the required units, if necessary. For some types of disk units, you 
or your service representative must perform tasks with the disk subsystem when 
you start device parity protection. 


Note: If you plan to start device parity protection for disk units that are already 
part of your disk configuration, check the following before you start device 
parity protection. 

* The configuration must be complete and no disk units can be missing in 
any ASPs that contain disk units that are to have device parity protection. 
This is because the system must move data off the disks that are to be 
protected to make room for parity information. 

* The disk units that will become device-parity protected cannot be in an 
ASP that has mirrored protection active. If the disk units are in an ASP 
that has mirrored protection, you must stop mirrored protection before 
starting device parity protection. 

* When you start device parity protection, you reduce the capacity of some 
of the disk units in the subsystem. The system must have sufficient 
storage in each affected ASP to make room for redundant parity data. 


How to Start Device Parity Protection for an Input/Output 
Adapter 


This topic lists the rules and describes the procedure for starting protection on 
V5R2 IOAs: 


* Maximum number of parity sets allowed: 8 (some adapters may support fewer 
parity sets) 

* Maximum number of devices per parity set: 18 

¢ Minimum number of devices per parity set: 3 

* All devices in a parity set must be the same capacity 


The IOA starts the fewest number of parity sets needed to protect all the devices of 
the same capacity. For example, to protect 10 devices, it starts one parity set of ten 
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devices. To protect 11 devices, it starts two parity sets: one parity set of seven 
devices and one parity set of four devices. At V5R2 you can use iSeries Navigator 
to optimize your parity sets for capacity, performance, or balanced (a mixture of the 
two). For more information see Systems management —> Disk management —> 
Disk pools in the iSeries Information Center at 

http: //www.ibm.com /eserver /iseries /infocenter. 


,_ Displays May Differ 
When you work with device parity protection, the displays you see may 
differ slightly from the displays in this book because of differences in disk 
subsystem requirements. The best way to ensure that you are running the 
correct step in each procedure is to refer to the titles of the displays. 


1. From the Use Dedicated Service Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 
b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 
c. Select option 5 (Work with device parity protection) on the Work with Disk 
Configuration display. 


2. Select option 2 (Start device parity protection) on the Work with Device Parity 
Protection display and press the Enter key. You are shown the Start Device 
Parity Protection display. It lists all the disk unit subsystems for which you can 
start device parity protection. 


(Gi 2) 


Start Device Parity Protection 
Select the subsystems to start device parity protection. 
Type choices, press Enter. 
1=Start device parity protection 
Parity Serial 


Resource Option Set Number Type Model Name 
1 2 3314025 6502 001 S101 
1 0000318 9337. 225 DDO13 

NS a a o 


3. Type a 1 in the Option column for the disk unit subsystems that you want to 
prepare to start device parity protection. Press the Enter key. 


If you are shown the following display, press Enter to continue. 


Confirm Continuation 
In order to proceed the system must perform internal processing that may 
take several minutes during which the system may appear inactive. Once you 
confirm to continue, the system must perform an IPL when you leave Work with 
Disk Configuration functions. 


Press Enter to continue. 
Press F12=Cancel to return to change your choice. 


4. Press the Enter key to continue. You are shown the Confirm Starting Device 
Parity Protection display. The display shows all the disk unit subsystems that 
you have selected and the individual disk units that are eligible to be started. 
Disk units that have an asterisk (*) in the ASP and Unit columns are not yet 
configured. 
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Confirm Starting Device Parity Protection During the 
preparation for starting device parity protection, data will be moved from 
parts of some disk units. This may take several minutes for each subsystem 
selected. Press Enter to continue. Press F12=Cancel to return and change 
your choice. 

Parity Serial 
Resource Option Set ASP Unit Number Type Model Name 
1 2 3314025 6502 8001 S101 
i Zanes *  00-0051556 6603 074 DD056 
1 Ze *  00-0020525 6603 074 DD025 
1 2 * *  00-0024030 6603 074 DD030 
1 ZN Gk *  00-0013026 6603 074 DD026 
1 2 x *  00-0024519 6603 074 DDO19 
1 2 *  00-0046338 6603 074 DD038 


SS y 


5. Notice: At this point, pressing the Enter key initiates the procedure for starting 
device parity protection. Once begun, this procedure continues to run until it is 
complete. If the subsystems that you have selected are correct, press the Enter 
key to continue. The status display shows how the operation is proceeding. 
When the system has completed its preparation for starting device parity 
protection on the selected subsystems, the following display is shown. 


Start Device Parity Protection Status 
The operation to start device parity protection will be done in several 
phases. The phases are listed here and the status will be indicated when 


known. 

Operation Status 
Initialize: disk: units: 3. 2. «ca 2. 2 (Running 
Prepaneritorsit arnt 2s; <2 ve) se. veaken, soe core) fou wes 

Start device parity protection. ....: % 


6. Press the Enter key to return to the Work with Device Parity Protection menu. 


Stopping Device Parity Protection 


When preparing to stop device parity protection, the system does validity checking 
to make sure that stopping device parity protection does not leave the system in a 
configuration that is not supported. The following restrictions apply when you 
stop device parity protection: 


* You cannot stop device parity protection on a subsystem when a unit in that 
subsystem is in a mirrored ASP. In order to stop device parity protection, 
mirrored protection must be stopped first. 


How to Stop Device Parity Protection on an Input/Output 
Adapter 


The following instructions only apply to IOAs that support device parity 
protection. 


1. If you are not already using DST, perform a manual IPL to start DST. See|“How| 
2. From the Use Dedicated Service Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 
b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 


c. Select option 5 (Work with device parity protection) on the Work with Disk 
Configuration display. 
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3. Select option 3 (Stop device parity protection) on the Work with Device Parity 
Protection display and press the Enter key. The following display is shown. 


Stop Device Parity Protection 
Select the subsystems to stop device parity protection. 
Type choices, press Enter. 
1=Stop device parity protection 
Parity Serial 
Resource Option Set Number Type Model Name 
1 1 = 10-4453031 6502 001 SI01 
2  00-00341 9337 212 DC09 


4. Type a 1 in the Option column for the disk unit subsystems that you want to 
stop device parity protection. Press the Enter key. The following display is 
shown. 


( => 


Confirm Stop Device Parity Protection 
Warning: Disk units connected to these subsystems will not be protected 
after you confirm your choices. 
Press Enter to continue. 
Press Fl2=Cancel to return and change your choices. 


Parity Serial 
Resource Option Set ASP Unit Number Type Model Name 
i al 10-4453031 6502 001 SI01 
1 1 8 3 00-0334602 6602 050 DDO12 
1 1 8 4 00-0334673 6602 050 ODDQO11 
1 1 8 5 @0-0231915 6602 050  DDO10 
1 1 8 6 00-0334610 6602 050  DDOOI 
il 1 8 7 00-0274937 6602 050  DDOO8 


= ey 


5. Notice: At this point, pressing the Enter key initiates the procedure for 
stopping device parity protection. Once this procedure has begun, you may not 
cancel it. If the subsystems you have selected are correct, press the Enter key to 
continue. You will get status screens. 


Stop Device Parity Protection Status 
The operation to stop device parity protection will be done in several 
phases. The phases are listed here and the status will be indicated when 


known. 

Operation Status 
Prepare to stop ..% 2% «<6 2 == «= ~ + Completed 
Stop device parity protection ... . . : Completed 


WARNING: There are now unprotected disk units on this system. When a system 
has unprotected, exposed, or suspended disk units attached to it, disk related 
failures may affect the availability of the system and can cause loss of data. 


Note: If you have not yet received “Completed” status you can press F16 to 
return to the Use Dedicated Service Tools (DST) menu if you have other 
tasks to perform. However, you cannot perform any disk configuration 
tasks or end DST until the system has finished starting device parity 
protection. 


6. When the status shows Completed, press the Enter key to return to the Work 
with Device Parity Protection menu. 
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How to Include a Disk Unit in Device Parity Protection 


When you attach a new disk unit to an existing IOA that has device parity 
protection, you can include the disk unit in the device parity set. You can include a 
disk unit by using either DST or SST. 


This topic lists the rules and describes the procedure for starting device parity 
protection for an IOA. The following are the basic rules for this type of IOA: 


* Maximum number of parity sets allowed: 8 (some adapters may support fewer 
parity sets) 

¢ Maximum number of devices per parity set: 18 

¢ Minimum number of devices per parity set: 3 


* All devices in a parity set must be the same capacity 


The devices will be included into an existing array. However, if enough devices 
exist to create a new array, the devices will be eligible for start but not include. 


Note: You cannot include a disk unit if that disk unit has already been added to 
an ASP that has mirrored protection. You must stop mirrored protection 
before including the disk unit. Stopping mirrored protection must be done 
from the DST menu. Adding mixed protection on the same IOP requires 
mirroring to be stopped and restarted. 

To include disk units in a device parity set, perform the following steps: 

1. From the System Service Tools (SST) menu, do the following: 

a. Select option 3 (Work with disk units). 

b. Select option 2 (Work with disk configuration) on the Work with Disk Units 
display. 

c. Select option 4 (Include unit in device parity protection) on the Work with 
Disk Configuration display. 


or from the Use Dedicated Service Tools (DST) menu, do the following: 


Note: If you are not already using DST, see |“How to Start Dedicated Service 
Tools (DST)” on page 395 


a. Select option 4 (Work with disk units). 

b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 

c. Select option 5 (Work with device parity protection) on the Work with Disk 
Configuration display. 

d. Select option 4 (Include unit in device parity protection) on the Work with 
Device Parity Protection display. 


The Include Disk Units in Device Parity Protection display appears: 
Include Disk Units in Device Parity Protection 


Select the units to be included in Device Parity Protection. 
Type choices, press Enter. 


l=Include unit in device parity protection 
Parity Serial 
Resource Option Set ASP Unit Number Type Model Name 
1 1 8 7 Q0-0274937 6602 050 DD0O8 
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2. Type a 1 in the Option column for the disk units that you want to include in 
device parity protection and press the Enter key. The following display is 
shown. 


Confirm Disk Units to be Included 
Including disk units in device parity protection may take a considerable 
amount of time. Press Enter to confirm your choice to have the system include 
the selected units in device parity protection 
Press F12=Cancel to return to change your choice 


Parity Serial 
Resource Option Set ASP Unit Number Type Model Name 
tt 1 8 7 @0-0274937 6602 070 DD0O8 


3. If the disk units that you selected are to be included in device parity protection, 
confirm this by pressing the Enter key. After the include operation has 
completed, the following display is shown. 


Include Disk Units in Device Parity Protection Status 
The operation to include units in the device parity protection will be done 
in several phases. The phases are listed here and the status will be indicated 


when known. 

Operation Status 

Prepare to include units ....... . : Completed 
Include:units> 2:43. 3 44 so 3.0% = & “Completed 


Note: You can press F16 to return to the Use Dedicated Service Tools (DST) 
menu if you have other tasks to perform. However, you cannot perform 
any disk configuration tasks or end DST until the system has finished 
including disk units in device parity protection. 


4. Press the Enter key to return to the Work with Device Parity Protection menu. 


How to Exclude a Disk Unit from Device Parity Protection 


You can exclude a disk unit that is attached to an IOA from device parity 
protection. You cannot exclude a disk unit that has been assigned to an ASP that 
has mirrored protection. To exclude a disk unit from device parity protection, do 
the following. 


1. If you are not already using DST, perform a manual IPL to start DST. See|“How] 
2. From the Use Dedicated Service Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 
b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 
c. Select option 5 (Work with device parity protection) on the Work with Disk 
Configuration display. 


3. Select option 5 (Exclude unit from device parity protection) on the Work with 
Device Parity Protection display and press the Enter key. The following display 
is shown. 
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Exclude Disk Units from Device Parity Protection 
Select the units to be excluded from Device Parity Protection. 
Type choices, press Enter. 
1=Exclude unit from device parity protection 


Parity Serial 
Resource Option Set ASP Unit Number Type Model Name 
1 1 8 7 00-0274937 6602 070 DDO08 


This display shows only disk units that are eligible to be excluded. A disk unit 
is eligible to be excluded if it does not contain parity information. If the disk 
units that you want to remove are not eligible to be excluded, you must stop 
device parity protection instead. Then physically remove the disk units and 
restart device parity protection. 

4. Type a 1 in the Option column for the disk units that you want to exclude from 
device parity protection and press the Enter key. The following display is 
shown. 


Confirm Disk Units to be Excluded 
Press Enter to confirm your choice to have the system exclude the selected 
units from device parity protection 
Press Fl2=Cancel to return to change your choice 


Parity Serial 
Resource Option Set ASP Unit Number Type Model Name 
1 1 8 7 00-0274937 6602 050 DD008 


5. If the disk units you selected are to be excluded from device parity protection, 
confirm this by pressing the Enter key. After the exclude operation has 
completed, the following display is shown. 


Exclude Disk Units in Device Parity Protection Status 
The operation to exclude units from the device parity protection will be done 
in several phases. The phases are listed here and the status will be indicated 


when known. 

Operation Status 

Prepare to exclude units ........: Completed 
Exclude: units: iinios 2). es ae caus ee 3 (COmplieted 


Note: You can press F16 to return to the Use Dedicated Service Tools (DST) 
menu if you have other tasks to perform. However, you cannot perform 
any disk configuration tasks or end DST until the system has finished 
excluding disk units in device parity protection. 


6. Press the Enter key to return to the Work with Device Parity Protection menu. 


How to Display Device Parity Status 


To display device parity status, do the following: 
1. From the System Service Tools (SST) menu, do the following: 
a. Select option 3 (Work with disk units). 
b. Select option 1 (Display disk configuration) on the Work with Disk Units 
display. 
or from the Use Dedicated Service Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 


Chapter 21. Working with Device Parity Protection 433 


cea disk hardware status F12=Cancel 


b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 

c. Select option 1 (Display disk configuration) on the Work with Disk 
Configuration display. 


d. Select option 1 (Display disk configuration status) on the Display Disk 
Configuration display. 


The Display Disk Configuration menu appears. 


Select option 5 (Display device parity status) on the Display Disk Configuration 
display and press the Enter key. The Display Device Parity Status display 
appears: 


Display Device Parity Status 


Parity Serial 
Resource Set ASP Unit Number Type Model Name Status 
1 10-4251006 6502 001 SI01 
* * @0-0128330 6602 074 DDO55 Active 
* * @0-0238703 6602 070 DDO53 Active 
* * @0-0162516 6602 074 DDO52 Active 
* * @0-0186325 6602 074 DDO51 Active 
* * @0-0103706 6602 074 DDO50 Active 
2 00-00341 9337 212 — DCI2 
* * @0-7000341 9337 212 DDO15 Active 
* * @0-5000341 9337 212 DDO34 Active 
* * @0-3000341 9337 212 DDO33 Active 
* * @0-2000341 9337 213 DDO12 Active 
* * 00-1000341 9337 212 DDO11 Active 


* - See help for more information 
Press Enter to continue. F3=Exit F5=Refresh 


The display is organized by device parity set. It includes controllers that can 
support device parity protection and all of the disk units that have the 
hardware capability for device parity protection. The possible values for the 
Status column are the following: 


Active This unit is part of a disk unit subsystem that has device parity 
protection. This unit is fully operational. 


Failed This unit is part of a disk unit subsystem that has device parity 
protection. This unit has failed. If another unit in the disk unit 
subsystem fails, data could be lost. 


% Rebuilt 
This unit is part of a disk unit subsystem that has device parity 
protection. The data on this unit is being rebuilt from other units in the 
disk unit subsystem. 


Unprotected 
This unit is part of a disk unit subsystem that has device parity 
protection. This unit is operational. However, another unit in the disk 
unit subsystem has failed or is being rebuilt. If another unit in the disk 
unit subsystem fails, data could be lost. 


% Resyncing 
The parity for the parity set is being built from the data within the disk 
unit subsystem. 
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How to Enable Disk Units Attached to the MFIOP to Use Device Parity 


Protection 


As illustrated in the preceding sections, some multi-function input/output 
processors (MFIOPs) can support device parity protection. However, disk units that 
were migrated from other RISC-based systems might not be in the correct format 
to allow device parity protection to be started. 


This section describes a conversion procedure for the disk units attached to the 
MFIOP so that device parity protection can be started. Ensure that the disk units 
and the MFIOP meet all of the following conditions before starting this procedure: 


* The disk units that are currently attached to the MFIOP have mirrored 
protection 

* All disk units with mirrored protection have a state of ‘Active’ 

* The MFIOP on the system supports device parity protection 

* All of the disk units that are attached to the MFIOP are the same capacity 


Mirrored protection cannot be running on a disk unit that is using device parity 
protection. In order to use the MFIOP capability to support device parity 
protection, you will have to stop mirrored protection on the loadsource disk unit. 
You should be aware that if you stop mirrored protection on the loadsource disk 
unit and replace mirrored protection with device parity protection, you could be 
reducing the system availability. 


Notes: 


1. With both device parity protection and mirrored protection, the system 
continues to run after a single disk failure. With mirrored protection, the 
system may continue to run after the failure of a disk-related component, such 
as a controller or an IOP. 


2. When a second disk failure occurs such that the system has two failed disks, 
the system is more likely to continue to run with mirrored protection than with 
device parity protection. 


1. If you are not already using DST, end all active jobs and_ power down the 
system. Perform a manual IPL to start DST. See "How to Start Dedicated] 
for information on starting DST. 

2. From the Use Dedicated Service Tools (DST) menu, do the following: 

a. Select option 4 (Work with disk units). 

b. Select option 1 (Work with disk configuration) on the Work with Disk 
Units display. 

c. Select option 1 (Display disk configuration) on the Work with Disk Units 
display. 

d. Select option 1 (Display disk configuration status) on the Display Disk 
Configuration display. 


The disk units and their status are displayed. 
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Display Disk Configuration Status 
Serial Resource 
ASP Unit Number Type Model Name Status 
1 Mirrored 
1 68-0C47591 6602 030 DDOO1 Active 
1 68-0119804 6602 030 DDQOZ Active 
2 68-0C60040 6602 030 DD0O3 Active 
2 68-54531 6602 050 DDO04 Active 
3 68-0C99140 6602 030 DDO12 Active 
3 68-5544453 6602 050 DDO1I1 Active 
5 10-1000128 9337 221 DDOO5 Active 
5 10-2000128 9337 221 DD006 Active 
7 ~=10-3000128 9337 221 DDOO7 Active 
7 =10-5000128 9337 221 DD0O8 Active 
= Be 


3. Press F9 to view the Display Disk Unit Details screen. 


fe Display Disk Unit Details ) 
Type option, press Enter. 
5=Display hardware resource information details 
Serial Sys Sys 1/0 1/0 
OPT ASP Unit Number Bus Card Adapter Bus Ctl Dev 
1 1 68-0C47591 Ih 1 0 0 1 0 
1 1 68-0119804 1 1 0 0 5 0 
1 2 68-0C60040 1 1 0 0 2 0 
1 2 68-54531 3 ih 0 0 2 0 
1 3 68-0C99140 1 1 0 0 3 0 
1 3 68-5544453 3 1 0 0 2 0 
1 5 10-1000128 2 5 0 1 0 
1 5 10-2000128 2 5 0 1 1 
1 7 10-3000128 2 5 0 1 2 
if 7 10-5000128 2 5 0 1 4 
S ed 


4. On the Display Disk Unit Details screen, locate the disk units which are on 
System Bus 1 and System Card 1. Those are the units that are attached to the 
Multi-function Input/Output Processor (MFIOP). Write down the unit 
numbers and serial numbers of those disk units. You will need that 
information in later steps. In the example above, the disk units with serial 
numbers 68-0C47591, 68-0119804, 68-0C60040, and 68-0C99140 are attached to 
the MFIOP. 

5. If none of the disk units that are attached to the MFIOP have a model of 030, 
you can exit this procedure at this time. 


6. Check to see if the following conditions exist: 
* There are only two disk units that are attached to the MFIOP 
* Both of those disk units are the load source disk units (unit 1) 
If these conditions exist, then you cannot use this procedure to convert the 
mirror-protected disk units to device parity protection. 


7. Ensure that all of the disk units that are attached to the MFIOP have identical 
capacities. If they are not identical, exit this procedure. 


8. The non-load source disk units which are attached to the MFIOP must be 
removed from the disk configuration. The load source disk unit will be 
processed in later steps. 


a. Select option 4 (Work with disk units). 


b. Select option 1 (Work with disk configuration) on the Work with Disk 
Units display. 
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c. Select option 3 (Work with ASP configuration) on the Work with Disk 
Configuration display. 


d. Select option 7 (Remove disk units from configuration) on the Work with 
ASP Configuraiton display. 


The Remove Units from Configuration screen is displayed. 


ie ; ’ = 
Remove Units from Configuration 
Type options, press Enter 
4=Remove unit from configuration 
Serial Resource 
OPT Unit ASP Number Type Model Name Status 
4 2 1 68-0C60040 6602 030 DDOQO3 Active 
4 2 1 68-54531 6602 050  DDO04 Active 
4 3 1 68-0C099140 6602 030 DDO12 Active 
4 3 1 68-5544453 6602 050 DDO11 Active 
5 1 10-1000128 9337 221 DDOO5 Active 
5 I 10-2000128 9337 221 DDO06 Active 
7 1 10-3000128 9337 221 DDOO7 Active 
a 7 1 10-5000128 9337 221 DD008 Active y 


9. Type a 4 (Remove unit from configuration) in the OPT column for each unit 
on the MFIOP that you want to remove and press the Enter key. In an earlier 
step, you wrote down the serial numbers and units of the disk units attached 
to the MFIOP. If the disk units that are attached to the MFIOP have mirrored 
protection, select both units of the mirrored pair. In the example above, the 
disk units with serial numbers 68—0C60040 and 68-0C99140 are attached to the 
MFIOP. Those correspond to units 2 and 3, so unit 2 and unit 3 have to be 
removed from the configuration. The mirrored pairs that contain those units 
were selected. 


10. The Confirm Continuation display may be shown before the Confirm Remove 
Disk Units display if the storage management directories are not usable. 


Confirm Continuation 


To proceed, the system must perform internal processing 
that may take several minutes during which the system may 
appear inactive. 


Press Enter to continue. 
Press Fl2=Cancel to return and change your choice. 


11. Press the Enter key. The Confirm Remove Disk Units display is shown: 
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Confirm Remove Disk Units 


Removing disk units will take several minutes. 


Press Enter to confirm remove of disk units. 
Press F9=Capacity information to display the capacity information 
Press F12=Cancel to return to change your choice 


Serial Resource 
OPT Unit ASP Number Type Model Name Status 
4 2 1 68-0C60040 6602 030 DDQO3 Active 
4 2 1 68-54531 6602 050  DDO04 Active 
4 3 al 68-0C99140 6602 030 DDO12 Active 
4 3 1 68-5544453 6602 050 ODDO11 Active 
ie ay 


12. Press the Enter key on the Confirm Remove Disk Units display to remove the 


13. 


14. 
15. 
16. 
17. 


18. 


19. 


20. 


selected units. The system moves the data off the units that are selected to be 
removed to the remaining units in the source ASP. 


Notes: 
a. The time it takes to remove a unit depends on the disk unit type and 
model. 


b. If the data on the unit being removed is severely fragmented and the 
amount of storage used is high, the remove operation could take several 
hours. 


When the remove operation is complete, you are returned to the Work with 
ASP Configuration display. 


Exit the Work with Disk Units function and return to the Use Dedicated 
Service Tools menu. 


Power off the system. 
Put the keylock in Normal mode. 
Power on the system. 


The system starts the IPL, and eventually the Sign On display appears. You 
will see the message Enter your user ID and password. 


When the IPL is complete, start the System Service Tools (SST). See[“Starting] 
System Service Tools (SST)” on page 396|for more information. 

The following steps will change the mirror-protected loadsource disk units 
from a model 030 so that device parity protection can be enabled on the disk 


units. The MFIOP cannot start device parity protection until all the disk units 
that are attached to the MFIOP have been correctly formatted. 


From the System Service Tools (SST) menu, do the following: 

a. Select option 3 (Work with disk units). 

b. Select option 3 (Work with disk unit recovery) on the Work with Disk 
Units display. 

c. Select option 3 (Suspend mirrored protection) on the Work with Disk Unit 
Recovery display. 

The Suspend Mirrored Protection display is shown. 
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Suspend Mirrored Protection 
Type options, press Enter 
1=Suspend Mirrored Protection 
Serial Resource 

OPT Unit ASP Number Type Model Name Status 
» ih 1 68-0C47591 6602 030 DDOO1 Active 
z 1 1 68-0119804 6602 030  DDOQOZ Active 
Bs 5 1 10-1000128 9337 221 DDOO5 Active 
a 5 1 10-2000128 9337 221 DD006 Active 
a 7 1 10-3000128 9337 221 DDOO7 Active 

7 1 10-5000128 9337 221 DD008 Active 

ho ey 


21. Type a1 (Suspend Mirrored Protection) in the Option column. Select a 
loadsource disk unit. 


22. Replace the suspended loadsource unit. The replace function initializes the 
disk units to the correct format so that device parity protection can be started 
on that disk unit. The model of the disk unit will not be 030 after the replace 
completes. 

a. Select option 3 (Work with disk units). 

b. Select option 3 (Work with disk unit recovery) on the Work with Disk 
Units display. 

c. Select option 1 (Replace configured unit) on the Work with Disk Unit 
Recovery display. 


The Select Configured Unit to Replace display is shown. 


Select Configured Unit to Replace 


Type option, press Enter. 


1=Select 
Serial Resource 
OPT Unit ASP Number Type Model Name Status 
1 1 1 68-0119804 6602 030 DDOe2 Suspended 


23. Type a 1 in the Option column on the Select Configured Unit to Replace 
display and press the Enter key. The only unit which should be displayed is 
the loadsource disk unit that was just suspended. 


( Select Replacement Unit +) 
Serial Resource 
Unit ASP Number Type Model Name Status 
th 1 68-0119804 6602 030 DDO0Z Suspended 
Type option, press Enter 
1=Select 
Serial Resource 
Option Number Type Model Name Status 
1 68-0C60040 6602 030 DD003 Non-configured 
_ 68-54531 6602 050 DD004 Non-configured 
= 68-0C99140 6602 030 DDO12 Non-configured 
= 68-5544453 6602 050 DDO11 Non-configured ) 


24. Type a 1 in the Option column on the Select Replacement Unit display and 
press the Enter key. Select a non-configured disk unit that is attached to the 
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MFIOP. You recorded the serial numbers of the disk units that are attached to 
the MFIOP in an earlier step. 


A 


Serial 
Unit ASP Number Type 
1 1 68-0119804 6602 


The replacement unit will be: 
Serial 


Unit ASP Number Type 
LL 1 1 68-0C60040 6602 


Mode 
030 


Mode 
050 


The configured unit being replaced is: 


Press Enter to confirm your choices for Replace. 
Press Fl2 to return to change your choices. 


Resource 
] Name 
DDeO2 


Resource 
] Name 
DD003 


Confirm Replace of Configured Unit 


This screen allows the confirmation of the configured unit to 
be replaced with the selected replacement unit. 


Status 
Suspended 


Status 
Resuming 


=~ 


25. Press Enter to confirm replacement. 


26. The replacement function runs for several minutes. Wait until the replacement 


function completes. 


27. From the System Service Tools (SST) menu, do the following: 


a. Select option 3 (Work with disk units). 


b. Select option 3 (Work with disk unit recovery) on the Work with Disk 


Units display. 


c. Select option 3 (Suspend mirrored protection) on the Work with Disk Unit 


Recovery display. 


The Suspend Mirrored Protection display is shown. 


a Suspend Mirrored Protection > 
Type option, press Enter. 
1=Suspend Mirrored Protection 
Serial Resource 
OPT Unit ASP Number Type Model Name Status 
1 1 il 68-0C47591 6602 030 DDOO1 Active 
- 1 1 68-0C60040 6602 050  DDQO3 Active 
a 5 1 10-1000128 9337 221 DDOO5 Active 
i 5 il 10-2000128 9337 221 DD006 Active 
= 7 1 10-3000128 9337 221 DD0OO7 Active 
7 1 10-5000128 9337 221 DD008 Active 
Nee 7 


28. Type a1 (Suspend Mirrored Protection) in the Option column. 
29. Replace the suspended loadsource unit. The replace function initializes the 


disk units to the correct format so that device parity protection can be utilized 
on that disk unit. The model of the disk unit will not be 030 when the replace 


function completes. 


a. Select option 3 (Work with disk units). 


b. Select option 3 (Work with disk unit recovery) on the Work with Disk 


Units display. 
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c. Select option 1 (Replace configured unit) on the Work with Disk Unit 
Recovery display. 


The Select Configured Unit to Replace display is shown. 


i 
Select Configured Unit to Replace *) 
Type option, press Enter. 
1=Select 
Serial Resource 
OPT Unit ASP Number Type Model Name Status 
1 il 1 68-0C47591 6602 030 DDOO1 Suspended 
S 4 


30. Type a 1 in the Option column on the Select Configured Unit to Replace 
display and press the Enter key. The only unit that should be displayed is the 
loadsource disk unit that was just suspended. 


(TS TEL Pa aT 


Select Replacement Unit 
Serial Resource 
Unit ASP Number Type Model Name Status 
1 1 68-0C47591 6602 030 DDOO1 Suspended 
Type option, press Enter 
1=Select 
Serial Resource 
Option Number Type Model Name Status 
1 68-0119804 6602 030 DDOe2 Non-configured 
- 68-54531 6602 050 DD004 Non-configured 
an 68-0C099140 6602 030 DDO12 Non-configured 
68-5544453 6602 050 DDO11 Non-configured 
Nea S 


31. Type a 1 in the Option column on the Select Replacement Unit display and 
press the Enter key. Select a non-configured disk unit that is attached to the 
MFIOP. You recorded the serial numbers of the disk units that are attached to 
the MFIOP in an earlier step. 


( > 


Confirm Replace of Configured Unit 


This screen allows the confirmation of the configured unit to 
be replaced with the selected replacement unit. 


Press Enter to confirm your choices for Replace. 
Press F12 to return to change your choices. 


The configured unit being replaced is: 


Serial Resource 
Unit ASP Number Type Model Name Status 
1 1 68-0C47591 6602 030 DDOe1 Suspended 


The replacement unit will be: 


Serial Resource 
Unit ASP Number Type Model Name Status 
o 1 1 68-0119804 6602 050 DDOe2 Resuming e 


32. Press Enter to confirm. 
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33. The replacement function runs for several minutes. Wait until the replacement 
function completes. 

34. Add the non-configured disk units to the system ASP. The Add function 
initializes the disk units so that device parity protection can be started on the 
disk units. 

35. Display the disk configuration again and ensure that the disk units which are 
attached to the MFIOP do not have a model 030. 

a. Select option 3 (Work with disk units). 

b. Select option 1 (Work with disk configuration) on the Work with Disk 
Units display. 

c. Select option 1 (Display disk configuration) on the Work with Disk 
Configuration display. 


The disk units and their status are displayed. Ensure that the disk units 
attached to the MFIOP are not model 030. 


lel ; ; i » 
Display Disk Configuration Status 
Serial Resource 
ASP Unit Number Type Model Name Status 
1 Mirrored 
1 68-0119804 6602 050  DDO002 Active 
1 68-0C60040 6602 050 DDO003 Active 
5  10-1000128 9337 221 DDOO5 Active 
5 10-2000128 9337 221 DDO06 Active 
7 =10-3000128 9337 221 DDOO7 Active 
7 10-5000128 9337 221 DDOD8 Active 
8 68-54531 6602 050 DDOQ04 Active 
8 68-0C99140 6602 050 DDO12 Active 
9 68-5544453 6602 050 DDO11 Active 
9 68-0C47591 6602 050 DDOO1 Active 
Ke ey 


36. Stop mirrored protection on the system ASP. See |“How to Stop Mirrored| 
Protection” on page 444 


otection” on page 446] for more information. 


37. Start_device parity protection on the disk units that are attached to the MFIOP. 
See}Starting Device Parity Protection” on page 427|/for the complete 


instructions on starting device parity protection 
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Chapter 22. Working with Mirrored Protection 


This chapter describes how to start and stop mirrored protection. It also describes 
the rules that apply when you set up a mirrored ASP. 


Mirrored Protection—Configuration Rules 


The following rules apply to mirrored configurations: 


* Mirrored protection is configured by ASP number. The system configures the 
two units of a mirrored pair within an ASP. 


* Mirrored protection requires an even number of storage units for each size of 
disk unit in the ASP that is being mirrored. An uneven number of storage units 
for any size of disk unit prevents mirrored protection from starting. This 
requirement does not apply to disk units that have device parity protection. 


* The system attempts to assign the two storage units of a mirrored pair so that a 
failed unit can be repaired while the system continues to use the other mirrored 
unit. For a hardware configuration where this is not possible, the repair of the 
failing unit must be delayed until the system can be powered down. This may 
be true for a failing mirrored unit which is sharing the same controller or I/O 
processor as its mirrored unit. 


* Standard DASD mirroring support requires that the mirrored units are at 
specific input and output addresses on the system. (For Version 3 Release 6, you 
can override this restriction with a patch.) Both units in the pair must be 
attached to the multi-function IOP because the system must be able to perform 
an IPL from either unit. Therefore, the system attempts to assign the mirrored 
units for unit 1 of the system ASP first. If you are mirroring the system ASP, 
mirrored protection does not start if valid mirrored units for unit 1 cannot be 
found. 


Note: Remote mirroring support removes this requirement and provides 
IOP-level or bus-level protection. 


How to Start Mirrored Protection 
You start mirrored protection for a specific ASP on your system. Before you 
attempt to start mirrored protection, you should ensure that the ASP meets the 
requirements that are described in|“Mirrored Protection—Configuration Rules”} If 
ou _are performing several disk configuration and disk protection tasks, refer to 
(Chapter 19|to determine the correct sequence of steps for your situation. 
To start mirrored protection, do the following: 


Logical partitioning users: If you perform an IPL on the primary partition, the 
secondary partitions will power down. If there is any 
activity on the secondary partitions when this occurs, 
the next IPL may be abnormal. You should quiesce all 
secondary partition activity before starting mirroring 
on the primary partition. 


1. If you are not already using DST, perform a manual IPL to start DST. See|“How] 
to Start Dedicated Service Tools (DST)” on page 395 
2. From the Use Dedicated Service Tools (DST) menu, do the following: 
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a. Select option 4 (Work with disk units). 

b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 

c. Select option 4 (Work with mirrored protection) on the the Work with Disk 
Configuration display. 


3. Select option 2 (Start mirrored protection) on the Work with Mirror Protection 
display. 


a 
Select ASP to Start Mirrored Protection *) 


Select the ASPs to start mirrored protection on. 


Type options, press Enter 
1=Select 

Option ASP Protection 
i 1 Unprotected 
1 2 Unprotected 


Xe 4 


4. Select the ASP or ASPs to be mirrored on the Select ASP to Start Mirrored 
Protection display and press the Enter key. Do not select ASPs that are 
protected with device parity protection. 

You may see the following display: 
Press the Enter key to continue. 


Confirm Continuation 
To proceed, the system must perform directory recovery, which may take a 
significant amount of time. The system may appear inactive during this time. 


Press Enter to continue. Press F12=Cancel to return and change your choices. 


5. The system shows a confirmation display of the new mirrored protection 
configuration, including the levels of protection. Notice that half of the 
previous unit numbers for units being mirrored in the ASP no longer exist. The 
storage units for those unit numbers have been paired with the storage units 
for the remaining unit numbers to make mirrored pairs. Also notice that device 
parity units in the ASP have not been affected. 


r > 


Confirm Start Mirrored Protection 


Press Enter to confirm your choice to start mirrored 
protection. During this process the system will be IPLed. 
You will return to the DST main menu after the IPL is 
complete. The system will have the displayed protection. 


Press Fl2 to return to change your choice. 


Serial Resource 
ASP Unit Number Type Model Name Protection 

1 Unprotected 
1 = 00-48519 6606 030 DD010 Unprotected 

2 Mirrored 
2  00-1000341 9337 211 DDQO12 Disk Unit 
2  00-5000341 9337 211 DDO15 Disk Unit 
3 00-0186325 6602 074 DD019 Device Parity 
4 00-0162516 6602 074 DD025 Device Parity 

a 5 00-0238703 6602 074 DD052 Device Parity y 


6. If the configuration is what you had planned_and you do not have other 
configuration changes to make, skip to step|7 on page 445 
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If the configuration is not what you had planned, for example, the level of 
protection is less, you have the following options: 


* Verify that the correct ASP was selected. Verify that any new storage units 
have been added to the correct ASP. 


* Determine if additional hardware is required to achieve the planned level of 
protection. 


* Determine if the existing hardware needs to be connected differently to 
achieve the planned level of protection. Contact your technical support 
organization for assistance. 


* Consider continuing the start mirrored protection process which will provide 
better availability than non-mirrored protection, rather than waiting until 
additional hardware arrives so that you can achieve your planned level of 
protection. After you receive and install the additional hardware, use 
fon page 383] to determine the procedure for configuring your disk storage 
correctly. Even on very large systems, the tasks to stop mirroring, add units, 
and start mirrored protection can be done in several hours. 


7. Place the system in Normal mode and press the Enter key to accept the 


( 


configuration. The system performs the first part of the process for starting 
mirrored protection. During that time, you are shown the Function Status 
display: 

The system updates the display periodically. 


Function Status 
You selected to start mirrored protection. 5 % Complete 


Note: You can press F16 to return to the Use Dedicated Service Tools (DST) 
menu if you have other tasks to perform. However, you cannot perform 
any disk configuration tasks or end DST until the system has finished 
starting mirrored protection. 


The system continues the start mirrored protection process in|What the System 
Does When You Start Mirrored Protection] without further operator 


intervention. 


8. After the system reaches the Command Entry display, you may want to create 


the QSYSMSG message queue to receive messages. If you have this message 
queue, the system sends certain critical messages to it. You can monitor the 
message queue with a program to make sure the messages are not missed. 


What the System Does When You Start Mirrored Protection 


The following steps are performed by the system when mirrored protection is 
started. 


1. 


Data is moved off half of the storage units in the selected ASPs. This can take 
from a few minutes to a few hours, depending on the amount of data that must 
be moved. 


Objects that are created on a preferred unit may be moved to another unit. The 
preferred unit number may no longer exist when mirrored protection starts. 
New control information is written to disk, describing the new mirrored system 
configuration. 

After the data is moved and the control information is written, the system 
performs an IPL. However, when you start mirroring only on independent 
ASPs, the system does not perform an IPL. 
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4. When the system reaches DST, the previously selected ASPs are mirrored, 
although the two storage units in the mirrored pairs are not yet synchronized. 


If the keylock switch is in the Manual position, you have the option to perform 
other configuration changes or perform an IPL. If you do not have 
configuration changes to make, select the option to perform an IPL and press 
the Enter key. 


If the keylock switch is in the Normal position, the system automatically 
continues the IPL. 


5. When the system continues the IPL past DST, the mirrored pairs are 
synchronized during storage management recovery. This can take a few hours, 
although this long recovery time only occurs when mirrored protection is first 
started, and not during every IPL on a mirrored system. The progress of the 
synchronization process is displayed and periodically updated on the control 
panel. The system will display the code SRC C6xx 4205 where xx indicates the 
completed percentage of the synchronization process. On very large systems, 
the entire start mirrored protection process can take up to approximately 8 to 
10 hours. 


6. After storage management recovery is completed, the selected ASPs have 
mirrored protection. 


Mirrored Protection Configuration Errors 


There can be no missing, active disk units anywhere in the configuration when 
mirroring is being started. Units with a status of missing must be powered, 
repaired, or replaced. 


Starting mirrored protection can fail if there is insufficient storage available in the 
ASP to contain the current data in the ASP. The percentage that is used in the ASP 
must normally be less than half of the ASP threshold. The exception to this occurs 
when the ASP contains device parity protected disk units that can allow starting 
mirrored protection with a greater percent used. 


There must be sufficient storage units in the ASP for the system to create mirrored 
pairs. If you receive_a message that indicates that the system cannot pair unit 1 or 
other units, review |“Mirrored Protection—Configuration Rules” on page 443} 


How to Stop Mirrored Protection 


When you stop mirrored protection, one unit from each mirrored pair becomes 
nonconfigured. Before you can stop mirrored protection for an ASP, at least one 
unit in each mirrored pair in that ASP must be present and not suspended. To 
control which mirrored unit of each pair becomes nonconfigured, you may 
suspend the storage units that you want to become nonconfigured. For units that 
are not suspended, the selection is automatic. 


To stop mirrored protection, do the following: 
1. If you are not already using DST, perform a manual IPL to start DST. See|"How] 
2. From the Use Dedicated Service Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 
b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 


c. Select option 4 (Work with mirrored protection) on the Work with Disk 
Configuration display. 
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3. Select option 3 (Stop mirrored protection) on the Work with Mirror Protection 
display. You are shown the Select ASP to Stop Mirrored Protection display: 


ie ' : Be 
Select ASP to Stop Mirrored Protection 


Select the ASPs to stop mirrored protection on. 


Type options, press Enter 
1=Select 


Option ASP Protection 
i! 2 Mirrored 


XN = 


4. Select the ASP or ASPs for which mirrored protection is to be stopped on the 
Select ASP to Stop Mirrored Protection display and press the Enter key. The 
Confirm Stop Mirrored Protection display is shown: 


"6 > 


Confirm Stop Mirrored Protection 


Press Enter to confirm your choice to stop mirrored 
protection. During this process the system will be IPLed. 
You will return to the DST main menu after the IPL is 
complete. The system will have the displayed protection. 


Press Fl2 to return to change your choice. 


Serial Resource 

ASP Unit Number Type Model Name Protection 
1 Unprotected 
1 00-48519 6606 030 DDO10 Unprotected 
2a Unprotected 
2  00-1000341 9337 211 DDQO12 Unprotected 

3 00-0186325 6602 074 DDO19 Device Parity 

4 00-0162516 6602 074 DD025 Device Parity 

x 5 00-0238703 6602 074 DD052 Device Parity ) 


5. Press the Enter key to confirm your choice. The system stops mirrored 
protection for the ASPs you requested and performs an IPL. However, when 
you stop mirroring on only independent ASPs, the system does not perform an 
IPL 
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Chapter 23. Working with Disk Compression 


This chapter describes how to start and stop disk compression. It also discusses 
various considerations for using disk compression. 


Introduction to Disk Compression 


Disk compression is a technology that increases the apparent capacity of disk 
storage devices by encoding the data to take up less physical storage space on 
disk. Disk compression is performed in the disk subsystem controller and does not 
affect the iSeries system processor. The compression and decompression of data is 
performed automatically on each write command and read command, respectively. 
With the exception of a performance impact, disk compression is transparent to 
applications. The performance of compressed disk drives is slower than the 
performance of non-compressed disk drives. This is due to the overhead of 
compression and decompression, and the variations in the length of the data that is 
written to disk. 


Typically, data that is found on disk units has a wide range of access requirements. 
You may choose to move data that is accessed infrequently, or data that does not 
require high performance I/O rates, to compressed disk units. Disk compression is 
intended to make infrequently accessed data available on-line at a lower cost. This 
storage alternative is positioned between non-compressed disk unit storage and 
optical or tape storage. 


Compressed disks have the same disk subsystem availability options of device 
parity protection and mirrored protection as non-compressed disks. Disk 
compression is only supported in user ASPs. 


Restrictions and Considerations 
The following restrictions and considerations apply to disk compression: 


* A compression-capable storage controller is required for the compressed disk 
units. 


* If you configured a 2748 or 2778 storage I/O controller for extended adaptive 
cache, you cannot use this controller for disk compression at the same time. 
However, you may re-configure the 2748 or the 2778 storage I/O controller for 
disk compression. 


The iSeries Information Center contains information on how to reconfigure your 
2748 or 2778 storage I/O controller. Search for "jumper” in the Information 
Center. Select the page about setting or changing the mode of an I/O card from 
the search results and follow the procedure. You can access the Information 
Center form the following Web site: 

http://www. ibm.com/eserver/iseries/infocenter 

* Disk compression is only allowed on certain types of disk units. Contact your 
service provider for the most current list of disk units which are capable of disk 
compression. 

* If you are using V4R3MO0 on your system, you can start or stop disk 
compression only on nonconfigured disk units. If you are using V4R4M0 or later 
on your system, you can start or stop disk compression on configured and 
nonconfigured disk units. 
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Note: If the disk unit is configured, you can only start disk compression if the 
disk unit is less than or equal to 92% full. You can only stop disk 
compression if there is room in the ASP for moving data off the disk unit 
so that the amount of data left on the disk unit is 92% of its 
uncompressed capacity. 


* Disk units that are compressed may not be added to the System ASP. You can 
only add compressed units to a User ASP. 


¢ A User ASP may contain compressed and non-compressed disk units. 


* A device parity protection set may contain compressed and non-compressed disk 
units. 


* If you are using mirrored protection, both disk units in the mirrored pair must 
have the same compression status (either both compressed or both 
non-compressed). 


* You may experience a zero to 30% performance degradation on I/O operations 
to compressed disk units. Your results may vary based on your actual work load 
characteristics. 


Disk Compression and Capacity 


Capacity gains may vary and are determined by the amount of compression that 
can be performed on the data. An overall 2:1 compression ratio should be expected 
for a disk unit. A maximum 4:1 compression ratio for a disk unit may be 
achievable in certain circumstances. Additionally, a compression ratio for a set of 
data on that disk unit may reach a maximum of 8:1. The iSeries software enforces 
the overall disk unit maximum compression ratio of 4:1. Because capacity is 
dependent on how well the data compresses, the capacity that is displayed will 
change as data is written to or deleted from the disk. The capacity that is 
displayed for a compressed disk unit is the amount of data on the disk plus an 
estimate of how much additional data can fit on the disk. 


The following example shows the calculation and display of capacity by the system 
for compressed disk units. The disk unit capacities are available on the Display 
Disk Configuration Capacity display under the DST menus and the SST menus. 
The capacities are also available on the Work with Disk Status (WRKDSKSTS) 
display. 


Note: If you have the licensed program 5769PT1 Performance Tools for iSeries 
installed on the system, you may use the system report to display the 
compression ratio. (You can find the ratio in the”Disk Compression 
Statistics” section in the system report.) 


1. Prior to starting compression, a nonconfigured 6602 Model 050 has a capacity 
of 1031 megabytes. 


Display Non-Configured Units 


Serial Resource 

Number Type Model Name Capacity Status 
83-0135199 6602 050 DDOO5 1031 Non-configured 
83-0306044 6602 050 DDOO6 1031 Non-configured 


2. After starting compression, the 6602 model number changes to 060, and the 
capacity doubles. 
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Serial 

Number Type 
83-0135199 6602 
83-0306044 6602 


Display Non-Configured Units 


Resource 
Model Name Capacity Status 
060 DDOO5 2062 Non-configured 
060 DDOO6 2062 Non-configured 


3. Two compressed disk units are added into user ASP 2. 


( Display Disk Configuration Capacity ) 
----Protected---- ---Unprotected--- 
ASP Unit Type Model Threshold Overflow Size % Used Size  %Used 
1 90% No 0 0.00% 21372 17.26% 
1 6607 050 0 0.00% 4194 29.25% 
2m 30713 050 0 0.00% 8589 14.33% 
39 76713 050 0 0.00% 8589 14.34% 
(3 90% No 0 0.00% 4124 90.10% 
5 6602 060 0 0.00% 2062 0.10% 
6 6602 060 0 0.00% 2062 0.10% 
be oy 
4. After writing data to the user ASP, capacities and percentages that are used are 
displayed. 
Saar >) 
Display Disk Configuration Capacity 
----Protected---- ---Unprotected--- 
ASP Unit Type Model Threshold Overflow Size % Used Size  %Used 
1 90% No 0 0.00% 21372 17.26% 
1 6607 050 0 0.00% 4194 29.25% 
2° 07:13: 050 0 0.00% 8589 14.33% 
32 67:13; 050 0 0.00% 8589 14.34% 
2 90% No 0 0.00% 5812 61.06% 
5 6602 060 0 0.00% 2905 61.04% 
6 6602 060 ) 0.00% 2907 61.08% 
~ | 


5. The following calculations may be performed to determine how well the data is 
being compressed, and the estimated disk unit capacity. These calculations may 
be performed on a user ASP basis, as well as on individual disk units. 


Amount 


Calculation 


Logical data written 
Physical free space 
Physical space used 
Compression ratio of data 
written 

Estimated disk capacity 


Using the values listed 


Size * (% Used / 100) 

(Size * (1-(% Used / 100)) / 2 
Non-compressed size - Physical free space 
Logical data written / Physical space used 


Logical data written + (2 * Physical free space) 


for Unit 5 in the preceding step with these formulas 


produces the following: 


Amount 


Calculation 


Logical data written 
Physical free space 
Physical space used 
Compression ratio 
Estimated disk capacity 


2905 * .6104 = 1773 
(2905 * (1-(.6104)) / 2 = 566 
1031 - 566 = 465 

1773 / 465 = 3.8 

1773 + (2 * 566) = 2905 
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Disk Unit Full Considerations 


As space is being reserved or data is being written to compressed disk units, it is 
possible for a unit to become temporarily full. The storage subsystem controller 
will detect this situation and attempt to reposition the data on the unit in order to 
maximize the amount of data that can be stored on the unit. This repositioning of 
the data increases the effective size of the disk unit. If the storage subsystem 
controller can not immediately service a system request, a failure will be returned 
to the system. The system bases its response to this failure on the type of I/O 
operation that is requested. One of the following scenarios may occur: 


* The system responds to this failure by overflowing the auxiliary storage pool 
(ASP). Once the overflow occurs, this I/O request will be performed in the 
system ASP and will succeed. 


* The system responds to this failure by displaying an A6xx 0277 system reference 
code (SRC) on the control panel in the system unit. The system displays this 
attention SRC until storage space becomes available on the disk unit that is 
denoted in the attention SRC. 


For more information, refer to|“How The System Responds to Disk Unit Full” 


When the system displays an A6xx 0277 attention SRC on the control panel, it also 
logs a corresponding A6xx 0277 record in the Product Activity Log. This occurs 
each time this disk unit full condition is detected. The system also sends message 
CPI116C "Compressed disk unit &1 is full” to the QSYSOPR message queue. The 
system will reissue the failed I/O operation and will continue to display the 
attention SRC on the control panel until the condition is corrected. When the 
storage subsystem controller creates sufficient space on the compressed. unit to 
contain the system request, the I/O operation completes successfully and the 
system resumes normal processing. 


While this attention SRC is being displayed, some I/O operations to the affected 
compressed disk unit may be suspended. As a result, you may observe that jobs 
which issue I/O operations to the affected unit appear to hang. 


To reduce the likelihood of system operations hanging while the storage subsystem 
recovers from a disk unit full condition, it is recommended that ASPs with 
compressed units operate with a storage threshold of less than or equal to 90%. 


As space on the disk unit continues to be used, eventually the storage subsystem 
controller can no longer store more data on the unit. At this point, the storage 
subsystem controller will return a failure on any system requests requiring storage 
apace, Relerio the following section How The Syiem Responds i Dik Uni ill 


for more information. 


How The System Responds to Disk Unit Full 


The system bases its response to the disk unit full condition on the type of I/O 
operation that was issued that caused the condition. 


If the system request is reserving additional storage space in the ASP, the 
compression recovery policy for the ASP determines the system response. You set 
this policy by using the Change ASP Attribute (CHGASPA) command. 


The system may respond to the disk unit full condition in one of the following 

ways: 

* If the compression recovery policy is *OVERFLOW, the system responds to this 
condition by overflowing the ASP. Once the overflow occurs, this I/O request 
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will be performed in the system ASP and will succeed. This is the system default 
compression recovery policy for all user ASPs. 


For more information, refer to|“How to Recover An Overflowed User Auxiliary 
Storage Pool” on page 195 


* If the compression recovery policy is *RETRY, the system responds to this 
condition by displaying an A6xx 0277 SRC on the control panel and repeatedly 
retrying the failed I/O operation. The system displays this attention SRC until 
storage space becomes available on the disk unit and the I/O operation 
succeeds. If storage space does not become available on the disk unit, the ASP 
overflows. The system removes the attention SRC from the control panel, and 
the I/O operation is successfully performed in the system ASP. 


For more Samer refer to|“How to Recover An Overflowed User Auxiliary 


* If the compression recovery policy is *WAIT, the system responds to this 
condition by displaying an A6xx 0277 SRC on the control panel and repeatedly 
retrying the failed I/O operation. If storage space does not become available on 
the disk unit, the ASP does not overflow. The user must take one of the 
corrective actions that are discussed in[‘SRC Code A6xx 0277” 


SRC Code A6xx 0277 


When you see the A6xx 0277 SRC code in the control panel, select the appropriate 
compression reference code word for additional information. The compression 
reference code word is either word 15 or word 17. In the V4R5 release, the 
compression reference code word format changed. 


Table 72. Word formats for SRC codes in V4R5. 


Word for the Word format Description 
SRC code 
5 (for models CCEE 0000 This word is the compression 
270 and 8xx) reference code that indicates two 
CC indicates the operation in things. First, it indicates which 
15 for all other | progress with the following values: operation was in progress. Second, 
models * 84 is an allocate operation it indicates whether or not the 
° 2x is a write operation where x is storage subsystem controller can 
1, 2, or 4 obtain additional storage space on 
the system. 


EE indicates the error code with the 


following values: This reference code word was 


formerly word 17 in the V4R4 


* 00 is the storage subsystem release and in previous releases. 


controller can not obtain any 
additional storage space on the 
unit 

* 02 is the storage subsystem 
controller will be able to obtain 
additional storage space on the 
unit 


6 (for models uuuu uuuU This word describes the unit 
270 and 8xx) address of the disk unit. 


16 for all other 
models 
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Table 72. Word formats for SRC codes in V4R5. (continued) 


7 (for models BBBB ccbb This word defines the bus, card, 
270 and 8xx) and board address of the disk unit. 


17 for all other 
models 


Note: The Information Center contains information that correlates the function and 
word for SRC codes on models 270, and 8xx. Look under System 
Administration, Availability, and Maintenance-> Logical 
Partitions->Troubleshooting logical partitions->Learning about system 
reference codes (SRC) for logical partitions. 


Table 73. SRC code word formats in V4R4 and previous releases. 


Word for the Word format Description 

SRC code 

15 0000 0000 Unassigned in V4R4 and previous 
releases. 

16 uuuu uuuu This word describes the unit 
address of the disk unit. 

17 CCEE BBcb Word 17 defines: the operation in 

a — progress, the error code; and the 
CC indicates the operation in bus, card, and board address of the 


progress with the following values: | disk unit. 
* 84 is an allocate operation 


* 2x is a write operation where x is 
1,2, or 4 


EE indicates the error code with the 
following values: 


* 00 is the storage subsystem 
controller can not obtain any 
additional storage space on the 
unit 

* 02 is the storage subsystem 
controller will be able to obtain 
additional storage space on the 
unit 


BBcb indicates the bus, card, and 
board address of the disk unit. 


Perform one of the three following actions in response to SRC A6xx 0277. 


User Action 1 


Wait for the storage subsystem controller to reposition the data on the disk unit. 


If the error code for EE of the attention SRC is 02, the storage subsystem controller 
will eventually obtain additional storage space on the unit, such that the I/O 
operation will succeed. If the system does not resume normal processing within 20 
minutes, contact your next level of support. 
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User Action 2 


Make storage space available in the ASP that contains the disk unit that is denoted 
in the SRC. 


Word 16 contains the unit address of the disk unit. Word 17 (V4R4 and previous) 
contains the right most characters as BBcb. Word 17 or 7 (V4R5) is BBBB ccbb. 
Refer to "Hardware Service Manager” in the iSeries Service Functions to correlate 
the unit address (logical address) with a resource name or serial number. The ASP 
that contains the disk unit can be determined by using the Display Disk 
Configuration Status display under the DST and SST menus. 


If the error code for EE of the attention SRC is 00, the storage subsystem controller 
determined that the disk unit is full. 


Perform one or more of the following actions: 

* Delete objects that are not needed from the ASP. 

* Save objects that are not needed from the ASP by specifying STG(*FREE) on the 
Save Object (SAVOBJ) command. 

* Move one or more libraries to a different ASP. 


Note: You cannot use the MOVOBJ command to do this. You must save the 
library, delete it, and then restore it to a different ASP. 


* Move one or more folders to a different ASP by saving the folder, deleting it, 
and restoring it to a different ASP. 


* Increase the storage capacity by adding disk units to the ASP. 


User Action 3 


Change the compression recovery policy to the desired system behavior. For more 
information on the CHGASPA command, refer to the iSeries server online help. 


User Action 4 


Re-IPL the system so that additional storage space can be made available in the 
ASP that contains the disk unit that was denoted in the attention SRC on the 
subsequent IPL. 


Word 16 contains the unit address of the disk unit. Word 17 (V4R4 and previous) 
contains the right most characters as BBcb. Word 17 or 7 (V4R5) is BBBB ccbb. 
Refer to "Hardware Service Manager” in the iSeries Service Functions to correlate 
the unit address (logical address) with a resource name or serial number. The ASP 
that contains the disk unit can be determined by using the Display Disk 
Configuration Status display under the DST and SST menus. 


If the error code for EE of the attention SRC is 00 and the system is holding critical 
resources, the system will eventually hang. The recommended recovery procedure 
is to re-IPL the system. The system must be in Manual mode. Perform the 
following steps: 


1. Force the system to write changed data in main storage to disk storage by 
pressing the power push-button twice to stop the system. Wait for system 
activity to stop. 


There will be changed data that is in main storage which can not be written to 
the disk unit. Therefore, the above system power off will eventually hang. 


2. Start an IPL. 
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a. Ensure that the keystick is in the system unit control panel. 

b. Place the system in manual mode. 

c. Press the Function Select switch (or buttons) to display 03 in the Function 

display. 
d. Press the Enter button on the control panel. 
3. On the following Manual mode IPL, perform one of the following: 

* Increase the storage capacity by adding disk units to the ASP at DST 

* Start the system to restricted state. Make storage space available in the ASP 
that contains the disk unit denoted in the attention SRC. Make the space 
available by performing one or more of the following steps: 
— Delete objects that are not needed from the ASP. 


— Save objects that are not needed from the ASP by specifying STG(*FREE) 
on the Save Object (SAVOBJ) command. 


— Move one or more libraries to a different ASP. 


Note: You cannot use the MOVOBJ command to do this. You must save 
the library, delete it, and restore it to a different ASP. 


— Move one or more folders to a different ASP by saving the folder, deleting 
it, and restoring it to a different ASP. 


Examples of A6xx 0277 


The following examples illustrate two situations where an A6xx 0277 SRC record 
will be generated, and any associated actions you may need to take. 


17 8402 0110 (V4R4 and previous)OR 150r5 8402 0000 (V4R5) 
In this example, an allocate operation (84) is being attempted and the error 
code (02) denotes the operation is being retried and will eventually 
succeed. You do not need to take any additional action. If the system does 
not resume normal processing within 20 minutes, contact your next level of 
support. 


If you want the system to overflow the user ASP into the system ASP, take 
User Action 3 that specifies the compression recovery policy *OVERFLOW, 
described above. 


17 2000 0110 (V4R4 and previous) OR 15 or 5 2000 0000 (V4R5) 
In this example, a write operation (20) is being attempted and the error 
code (00) denotes that the operation is being retried indefinitely, because 
the storage subsystem controller has determined that there is no storage 
space available on the disk unit. Take either User Action 2 or User Action 
4, described above. 


How to Start Disk Compression 


You can start disk compression from the Dedicated Service Tools (DST) menu. 
Note: 


You can use a 2748 storage I/O controller for extended adaptive cache or 
disk compression, but not both at the same time. The Information Center 
contains information on how to configure your 2748 storage I/O controller. 
Look under the Storage I/O card modes and jumpers information in the 
Information Center Website: 

http:/ /www.ibm.com/eserver/iseries /infocenter. 
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The V4R5 navigation path to this information is System 
Management-—>System hardware—>Storage I/O card modes and 
jumpers—>Setting or changing the mode of an I/O card. 


To start disk compression from DST, perform the following steps. 


1. If your use your 2748 storage I/O controller for compression, make sure that 
you set the jumper for compression mode before you continue with the 
following steps. See 


2. If you are not already using DST, perform a manual IPL to start DST. See|How] 
3. From the Use Dedicated Services Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 
b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 
c. Select option 6 (Work with disk compression) on the Work with Disk 
Configuration display. 
4. Select option 2 on the Work with Disk Compression . 


i . 


Work with Disk Compression 
Select one of the following: 
1. Display disk compression status 


2. Start compression on disk units 
3. Stop compression on disk units 


Selection 


F3=Exit F12=Cancel 
\ 4 


5. Select the disk units that you want to start compression on from the Select Disk 
Units for Start Compression screen. 


Note: You can only start compression on a configured unit if the disk unit is 
less than or equal to 92% full. 


a >) 


Select Disk Units for Start Compression 
Select the units for start compression. 


Type choice, press Enter. 
1=Start compression 


Serial Resource 
OPT Unit ASP Number Type Model Name Status 
1 68-7FODB 6607 050 DDOO5 Non-configured 
68-5FBQB 6713 050 DDOO1 Non-configured 


F3=Exit F12=Cancel 
& 
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6. You are shown the Confirm Disk Units for Start Compression screen. This 
display shows the approximate amount of time that is required to start disk 
compression, and the current and proposed sizes of the disk unit. 


a se 


Confirm Disk Units for Start Compression 
Estimated time for this operation to complete : 14-16 Minutes 
Press Enter to confirm your choice to compress the disk units. 


Press F9=Capacity Information to display the resulting capacity. 
Press F12=Cancel to return to change your choice. 


Serial Current Proposed 
OPT ASP Unit Number Type Model Size Size 
1 68-7FODB 6607 050 4194 8388 
F9=Resulting Capacity F12=Cancel 


7. At the Confirm Disk Units for Start Compression screen, press Enter to confirm 
your choice of disk units that you want to start compression on. You are shown 
the Start Compression on Disk Unit Status screen. 


Start Compression on Disk Unit Status 
Estimated time for this operation to complete : 14-16 Minutes 
The operation to start compression on the selected disk units 


will be done in multiple phases. The phases are listed here 
and the status will be updated as the phase proceeds. 


Phase Status 
Prepare to start compression. .....: 0 % Complete 


Start. compression <3. 2 6 hs et ese SS 
Prepare to compress data ........:3 
Compressdata: 3.52. 8 ke eae ee 


Wait for next display or press F16 for DST menu 


y 


8. After the start compression operation completes, you are returned to the Work 
with Disk Compression screen, and shown a completion message. 
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a _ 


Work with Disk Compression 
Select one of the following: 
1. Display disk compression status 


2. Start compression on disk units 
3. Stop compression on disk units 


Selection 


F3=Exit F12=Cancel 
The requested compression operation completed successfully. 


How to Stop Disk Compression 


To stop disk compression from DST, perform the following steps. 
1. If you are not already using DST, perform a manual IPL to start DST. See|“How] 
2. From the Use Dedicated Services Tools (DST) menu, do the following: 
a. Select option 4 (Work with disk units). 
b. Select option 1 (Work with disk configuration) on the Work with Disk Units 
display. 
c. Select option 6 (Work with disk compression) on the Work with Disk 
Configuration display. 
3. Select option 3 on the Work with Disk Compression screen. 


( a 


Work with Disk Compression 
Select one of the following: 
1. Display disk compression status 


2. Start compression on disk units 
3. Stop compression on disk units 


Selection 


F3=Exit F12=Cancel 
NS ey 


4. Select the disk units that you want to stop compression on from the Select Disk 
Units for Start Compression screen. 


Note: Compression can only be stopped if there is room in the ASP for moving 
data off of the disk unit. Once the data has been moved off, the amount 
of data that is left on the disk is less than or equal to 92% of its 
uncompressed capacity. 


Chapter 23. Working with Disk Compression 459 


- >) 


Select Disk Units for Stop Compression 
Select the units for stop compression. 


Type choice, press Enter. 
1=Stop compression 


Serial Resource 
OPT Unit ASP Number Type Model Name Status 
1 68-7FODB 6607 060 DDOO5 Non-configured 


F3=Exit F12=Cancel 
ee 


5. You are shown the Confirm Disk Units for Stop Compression screen. This 
display shows the approximate amount of time that is required to stop disk 
compression, and the current and proposed sizes of the disk unit. 


(— aN 


Confirm Disk Units for Stop Compression 
Estimated time for this operation to complete : 1-2 Minutes 


Press Enter to confirm stop compression. 
Press F9=Capacity Information to display the resulting capacity. 
Press Fl2=Cancel to return to change your choice. 


Serial Current Proposed 
OPT ASP Unit Number Type Model Size Size 
dL 68-7FODB 6607 060 8388 4194 


F9=Resulting Capacity F12=Cancel 
S 


6. At the Confirm Disk Units for Stop Compression screen, press Enter to confirm 
your choice of disk units that you want to stop compression on. You are shown 
the Stop Compression on Disk Unit Status screen. 


a = 


Stop Compression on Disk Unit Status 
Estimated time for this operation to complete : 1-2 Minutes 
The operation to stop compression on the selected disk units 


will be done in multiple phases. The phases are listed here 
and the status will be updated as the phase proceeds. 


Phase Status 
Prepare to stop compression ......: 0 % Complete 


STOP COMPVESSITOMEs (te: ye: eure. Gorges a te ey ens 


Ne ey 


7. After the stop compression operation completes, you are returned to the Work 
with Disk Compression screen, and shown a completion message. 


460 0S/400 Backup and Recovery V5R2 
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Work with Disk Compression 
Select one of the following: 
1. Display disk compression status 


2. Start compression on disk units 
3. Stop compression on disk units 


Selection 


F3=Exit F12=Cancel 
The requested compression operation completed successfully. 


Procedural Sequences for Configuring Disks and Protection 


Each respective configuration change requires you to perform procedures in a 
specific order. The following lists show the order that you should use when 
performing the procedures. 


Adding a New I/O Compression-Capable Storage Controller 


This checklist shows the sequence of tasks that you use to add a new 
compression-capable I/O Storage Controller and disk units to your system. 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as you 
or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you to diagnose any 
problems that occur. 


Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 


Table 74. Adding a New I/O Storage Controller and Disk Units 


Task What to Do Where to Read More About It 
___Task1 Install the new storage controller in the 
system. This is normally done by a service 
representative. 
___Task 2 Physically attach disk units to the new 
storage controller. This is normally done by a 
service representative. 
___Task 3 Start DST. “How to Start Dedicated Service Tools 
(DST)” on page 395 
___Task 4 Print your current disk configuration. “How to Display Your Disk Configuration” 
on page 39 
___Task 5 If you want to have device parity protection |How to Start Device Parity Protection for 
for the storage controller, start device parity {an Input/Output Adapter” on page 427) 
protection now. 
___Task 6 Start disk compression on nonconfigured disk |“How to Start Disk Compression” on 


units. page 456 
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Table 74. Adding a New I/O Storage Controller and Disk Units (continued) 


Task What to Do Where to Read More About It 
___Task 7 Add nonconfigured disk units to the correct |“How to Add Disk Units to an Auxiliary 
ASPs. You can add the disk units to an Storage Pool” on page 403 


existing user ASP or to a new ASP. If you are 
adding disk units to an ASP that has 
mirrored protection and the new disk units 
do not have device parity protection, you 
must add pairs of disk units that have equal 


capacities. 
___Task 8 If you created a new ASP on your system “How to Change the Storage Threshold for 
when you added disk units, the system set an Auxiliary Storage Pool” on page 40 


the storage threshold of the ASP to 90%. If 
you want a different threshold, change it at 
this time. 


___Task 9 If you created any new ASPs and you want “How to Start Mirrored Protection” on 
those ASPs to have mirrored protection, start |page 443 
mirrored protection now. 


___Task 10 Verify that your disk configuration is correct. |“How_to Display Your Disk Configuration” 
___Task 11 End DST. “How to Stop Dedicated Service Tools 


(DST)” on page 396 


Adding Disk Units to an Existing Compression-Capable 
Storage Controller 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as you 
or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you to diagnose any 
problems that occur. 


Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 


Table 75. Adding Compressed Disk Units to an Existing Storage Controller 
Task What to Do Where to Read More About It 


___Task1 Physically attach disk units to an existing 
storage controller. This is normally done by a 
service representative. 


___Task 2 Start DST or SST. 


“How to Start Dedicated Service Tools 
DST)” on page 395|or|“Starting System| 


Service Tools (SST)” on page 396 
___Task 3 Print your current disk configuration. “How to Display Your Disk Configuration” 
___Task 4 Include the disk units that you want to “How to Include a Disk Unit in Device 


protect in device parity protection. Parity Protection” on page 431 


___Task 5 Start disk compression on nonconfigured disk |“How to Start Disk Compression” on 


units. page 456 
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Table 75. Adding Compressed Disk Units to an Existing Storage Controller (continued) 


Task What to Do Where to Read More About It 
___Task 6 Add nonconfigured disk units to the correct |“How to Add Disk Units to an Auxiliary 
ASPs. You can add the disk units to an Storage Pool” on page 403 
existing user ASP or to a new ASP. If you are 
adding disk units to an ASP that has 
mirrored protection and the new disk units 
do not have device parity protection, you 
must add pairs of disk units that have equal 
capacities. 
___Task 7 If you created a new ASP on your system “How to Change the Storage Threshold for 
when you added disk units, the system set an Auxiliary Storage Pool” on page 406 
the storage threshold of the ASP to 90%. If 
you want a different threshold, change it at 
this time. 
___Task 8 If you created any new ASPs and you want “How to Start Mirrored Protection” o 
those ASPs to have mirrored protection, start 
mirrored protection now. 
___Task 9 Verify that your disk configuration is correct. |“How_to Display Your Disk Configuration” 
___Task 10 End DST or SST. “How to Stop Dedicated Service Tools 


DST)” on page 396] or| pp 
Service Tools (SST)” on page 396 


Moving Disk Units from the System ASP to a User ASP 


This checklist shows the sequence of tasks that you use to move one or more disk 
units from the System ASP to a User ASP. This checklist assumes that the disk 
units are attached to a compression-capable subsystem storage controller. 


Before you begin, make a copy of this checklist. Fill in the appropriate areas as you 
or the service representative perform the configuration tasks. This checklist 
provides an important record of your actions. It may help you diagnose any 


problems that occur. 


Attention: When you perform the tasks in this checklist, the system moves large 
amounts of data. Make sure that you have saved your system 
completely in the event that you need to recover from an error 


situation. 


Most tasks in the checklist include references to other topics in this book. Refer to 
these topics if you need more information about how to perform a particular task. 


Table 76. Moving Disk Units from the System ASP to a User ASP 


Task What to Do Where to Read More About It 
___Task1 Print your current disk configuration. “How to Display Your Disk Configuration” 
___Task 2 Calculate the space requirements for both the [Calculating Space Requirements for an 
source and target ASPs for the disk units. Auxiliary Storage Pool” on page 414 
___Task 3 Use option 21 from the Save menu to save “Save your server with the GO SAVE 
your entire system. command” on page 15 
___Task 4 Start DST. “How to Start Dedicated Service Tools 


(DST)” on page 395 
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Table 76. Moving Disk Units from the System ASP to a User ASP (continued) 
Task What to Do Where to Read More About It 


___Task 5 Remove disk units that you plan to add toa__|“How to Remove a Disk Unit from an 
different ASP. Auxiliary Storage Pool” on page 411 


Task 6 If you wish to use device parity protection, “How to Start Device Parity Protection for 
_ start device parity protection (if necessary), 
and include the disk units that you want to 
protect. If you do not wish to use device 
parity protection, proceed to the next step. 


___Task 7 Start disk compression on nonconfigured disk |“How to Start Disk Compression” on 
units. page 456 

___Task 8 Add nonconfigured disk units to the correct [How _to Add Disk Units to an Auxiliar 
ASPs. You can add the disk units to an Storage Pool” on page 403 


existing user ASP or to a new ASP. If you are 
adding disk units to an ASP that has 
mirrored protection and the new disk units 
do not have device parity protection, you 
must add pairs of disk units that have equal 
capacities. 


Task 9 If you created a new ASP on your system “How to Change the Storage Threshold for 
a when you added disk units, the system set an Auxiliary Storage Pool” on page 40 
the storage threshold of the ASP to 90%. If 
you want a different threshold, change it at 
this time. 


___Task 10 If you created any new ASPs and you want “How to Start Mirrored Protection” on 
page 443} 


those ASPs to have mirrored protection, start |page 443 
mirrored protection now. 


___Task 11 Verify that your disk configuration is correct. |“How to Display Your Disk Configuration” 
___Task 12 End DST. “How to Stop Dedicated Service Tools 


(DST)” on page 396 


___Task 13 If necessary, move objects between ASPs. “Transferring Objects between Auxiliary 


Storage Pools” on page 416 


Recovering from Error Codes 


You may encounter SRC codes when working with disk compression. This section 
discusses some causes of SRC codes, and how to respond to them. You may want 


to refer to [Chapter 20, “Working with Auxiliary Storage Pools” on page 403} for 


information on moving disk units into and out of auxiliary storage pools (ASPs). 


Recovering from SRC 6xxx 7051 


You are receiving this message because the compressed device and the 
compression input/output adapter (IOA) are not compatible. 


1. Did you remove the disk unit from another system? 


Yes No 


v Go to step]6 on page 465 


2. Was it removed from the ASP of the other system? 
Yes No 


v Go to step|4 on page 465 
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Stop compression on the disk unit. 
This ends the procedure. 
Do you want to save the data that is on the disk unit? 
Yes No 
V Stop compression on the disk unit. 
This ends the procedure. 
Return the disk unit to its original system and IOA and perform the following: 
a. Remove the disk unit from the ASP. 
b. Stop compression on the disk unit. 


Reinstall the disk unit to this system. 


This ends the procedure. 
The IOP or IOA that you are using is not compatible with the disk unit. 
Do you want to save the data that is on the disk unit? 


Yes No 
V Stop compression on the disk unit. 


This ends the procedure. 


If you came here from another procedure, return there and follow the 
procedure, otherwise contact your next level of support. 


This ends the procedure. 


Recovering from SRC 6xxx 7052 


You are receiving this message because the counter that tracks the number of write 
operations to this drive has reached 75% of its maximum value. This counter is 
used to determine if data on the drive is current with data within IOA memory. 
Since this counter is large, it is not necessary to stop compression for this drive 
immediately, but you should do so during your next scheduled maintenance. If 
this counter wraps, data can be lost. 


To stop compression and restart compression on the disk drive to reset the write 
count, perform the following: 


1. 


OO ew 


Perform a Manual Mode IPL to DST. (Refer to “Dedicated Service Tools (DST)” 
in the iSeries Service Functions for more information.) 


To find the resource name of the disk drive with the problem, perform the 
following: 


. Select the Use Dedicated Service Tools option. 
. Select the Start a service tool option. 

. Select the Hardware service manager option. 

. Select the Work with service action log option. 
. Select the time frame of the problem. 


™-™ OoOaQon»#e ® 


Record the resource name that is associated with the 6xxx 7052 entry in the 
SRC column. 


Remove the disk unit from the ASP. 

Stop compression on the disk unit. 

Start compression on the disk unit. 

Add the disk drive back to the ASP from which it was removed. 
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This ends the procedure. 
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Chapter 24. Managing Auxiliary Storage Pools 


Auxiliary Storage Pools (ASPs) separate disk units into logical subsets, which can 
give you a number of advantages. Using ASPs helps protect your data. By 
separating libraries, documents, or other objects in an ASP, you protect them from 
data loss should a disk unit in a different ASP fail. The importance of protecting 
the data in the ASP and the capacity of the ASP are factors in determining what 
protection mechanisms (mirroring or device parity, for example) you choose to 
implement on the disk units in each ASP. Independent ASPs are unique in that you 
can make them available or unavailable as you need the information. This allows 
you to store low-usage data offline until it needs to be accessed, thus reducing 
system start time. In a clustered environment you can configure independent ASPs 
to switch between systems. To learn more about the benefits of independent ASPs, 
also called independent disk pools in iSeries Navigator, see the iSeries Information 
Center at http://www.ibm.com/eserver /iseries /infocenter. 


Using ASPs also increases performance. You can place libraries or objects in an 
ASP, allowing you to dedicate the disk units in the ASP exclusively for the use of 
those objects. If you do extensive journaling, a dedicated disk unit for the journal 
receiver can also improve journaling performance. 


Note: Placing many active journal receivers in the same user ASP is not 
productive. The resulting contention between writing to more than one 
receiver in the ASP can slow system performance. For maximum 
performance, place each active journal receiver in a separate user ASP. 


You can improve system performance by using the|ASP Trace and ASP Balance 


features. 


Changing ASP size may involve |determining adequate disk storage||“How to Add| 
Disk Units to an Auxiliary Storage Pool” on page 403] and 
Auxiliary Storage Pool” on page 413 


If the amount of data in a storage pool increases, you may need to increase the size 
of the storage pool. Conversely, if data in a storage pool decreases, you may want 
to decrease the size of that storage pool and use the disk space elsewhere. 


Changing the size of an ASP can mean adding a disk unit, removing a disk unit, 
moving a disk unit, or deleting an ASP from the system. You must typically have 
QSECOFR authority to access these tasks. 


Working with ASP Trace and ASP Balance 


There are three types of balancing action a user can choose: 


Capacity Balance 
Hierarchical Storage Management (HSM) 


The balancing actions use the results of previous ASP traces to_ determine disk unit 


usage. Therefore, an ASP balance will be more effective if you|perform an ASP 
fe 


race] first. 
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The following restrictions and considerations: 


* The Usage Balance uses the results of previous ASP traces to determine the disk 
unit usage. You must}perform an ASP trace}before you run a Usage Balance. 
* The Heirarchical Storage Management (HSM) Balance uses the results of 


previous ASP traces to determine the disk unit usage. You must |perform an ASP 
before you can run a HSM Balance. 


* The Heirarchical Storage Management (HSM) Balance requires a mixture of 
compressed and non-compressed disk units in the ASP. 


* The system will experience degraded performance during the Trace activity and 
Balance activity. 


* You can only use the Trace and Balance functions in Auxiliary Storage Pools 
which contain more than one disk unit. 


* You can add a non-configured disk unit to the configuration during the time a 
Trace is running. In this case the system will automatically include the newly 
configured disk unit in the trace activity. 


* You can only run a single Trace activity or Balance activity at a given time to an 
Auxiliary Storage Pool. 


* The amount of improvement in system throughput that is achieved by running 
the balance is dependent on many factors. This includes some of the following 
items. 


— The amount of mainstore. 

— The number of processors. 

— The level of activity running on the system. 

— The amount of cache in the storage subsystem. 


— The quantity of disk arms under each I/O Processor in each storage 
subsystem. 


Capacity Balance 


The Capacity Balance function rearranges the data on all of the disk units within 
an Auxiliary Storage Pool. It moves data so that each disk unit has an equal 
percentage of used and unused space. This is useful when you add new units to 
an Auxiliary Storage Pool. We want to avoid the situation where several disk units 
contain the majority of the data and the newly added disk units contain very little 
data. This situation leads to poor system performace. The balance function spreads 
the data in the ASP evenly across all of the disk units. 


Below is a display which shows the effects of using Capacity Balance. Before using 
Capacity Balance the recently added Unit 4 contained very little data. The system 
storage management allocates newly created data to the disk unit that has the 
lowest percentage of capacity used. Thus, the system routes all new storage 
allocations to the unit 4. If the system uses that newly created data frequently, a 
potential bottleneck is created. The system directs all of the I/O operations to a 
single disk unit instead of spreading it across all units in the ASP. The Capacity 
Balance performed on the ASP allows the data to be evenly distributed across all 
of the disk units in the ASP. This means that the distribution of future space 
allocation on the disk units in the ASP is even across all of the disk units in the 
ASP. That ensures that the I/O to those allocates are also evenly spread out 
amongst the disk units instead of being concentrated on the newly added disk 
unit. 
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Unit Before Capacity Balancing After Capacity Balancing 
Disk Size % Used Disk Size % Used 

1 1967 54.59% 1967 55.69% 
2. 1031 68.45% 1031 55.80% 
3 1031 68.41% 1031 55.76% 
4 1031 0.30% 1031 55.77% 


To start Capacity Balance via a CL command use the Start ASP Balance 
(STRASPBAL) command. For example, if you want to start a capacity balance on 
ASP 4 and have it run for 25 minutes, enter the following command: STRASPBAL 
ASP(4) TYPE@CAPACITY) TIMLMT(25). 


If you want to end a Capacity Balance before the time limit requested is reached, 
use the End ASP Balance (ENDASPBAL) command. For example, if you want to 
end a running capacity balance on ASP 4, enter the following command: 
ENDASPBAL ASP(4). 


Hierarchical Storage Management (HSM) Balance 


The high-use and low-use data on each disk unit in the ASP is redistributed. This 
is done so that the high-use data resides on ‘fast’ disk units and the low-use data 
resides on compression disk units, which are typically slower than standard disk 
units. The ASP selected for a HSM Balance must have a combination of 
compression disk units and non-compression disk units. You can only run a HSM 
Balance following a Trace ASP Balance. The Trace ASP Balance function monitors 
the I/O activity on each of the disk units in the ASP to determine where the 
high-use and low-use data resides. 


Compression disk units have larger capacity, but are somewhat slower than 
non-compression disk units. This is due to the overhead of compression and 
decompression, and the variations in the length of the data that is written to disk. 
Typically, data that is found on disk units has a wide range of access requirements. 
The HSM balance function moves data that is accessed infrequently to compression 
disk units. Disk compression makes infrequently accessed data available on-line at 
a lower cost. System throughput improves when you move high-use data off of 
compression disk units. Moving the low-use data to the large compression disk 
units makes additional capacity available on the standard disk units so high-use 
data can be allocated. 


The Start ASP Balance (STRASPBAL) command is used to perform the HSM 
Balance function. For example, if you want to run a HSM balance on ASP 4 for 25 
minutes, enter the following command: STRASPBAL ASP(4) TYPE“HSM) 
TIMLMT(25). 


If you want to end a HSM Balance before the time limit requested is reached, use 
the End ASP Balance (ENDASPBAL) command. For example, if you want to end a 
running HSM balance on ASP 4, enter the following command: ENDASPBAL 
ASP(4). 


Usage Balance 


The Usage Balance attempts to balance the usage of the disk units in an Auxiliary 
Storage Pool. The Usage Balance can only be done following a Trace ASP Balance. 
The Trace ASP Balance function monitors the I/O activity on each of the disk units 
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in the ASP. It then determines where the frequently used and infrequently used 
data resides. The Usage Balance function utilizes that trace information. It adjusts 
the data on the disk units so future system activity will be more equally balanced 
amongst the disk units in the ASP. 


If the system determines that all of the disk units are of approximately equal 
utilization, the balance will end very quickly. The Balance Usage function uses the 
Trace information in its calculations. If the trace data is old, or if your applications 
have changed to reference different data since the trace was run, the Usage Balance 
could result in very little improvement in your system throughput. It might even 
cause the throughput to decrease somewhat. 


The Start ASP Balance (STRASPBAL) command is used to perform the Archive 
Balance function. For example, if you want to start a usage balance on ASP 4 to 
run for 25 minutes, enter the following command: STRASPBAL ASP(4) 
TYPE(*USAGE) TIMLMT(25). 


If you want to end a Usage Balance before the time limit requested is reached, use 
the End ASP Balance (ENDASPBAL) command. For example, if you want to end a 
running usage balance on ASP 4, enter the following command: ENDASPBAL 
ASP(4). 


ASP Trace 


The Trace ASP Balance command monitors the frequency that data is accessed on 
the disk units in the Auxiliary Storage Pool. Each I/O to the disk units is 
monitored, and the results are recorded for use by the Balance commands. The 
statistics which are collected are cumulative. For example, suppose you start one 
Trace and it runs for 35 minutes. Then you start another trace on that ASP and it 
runs for 15 minutes. The second group of statistics is added to the first collection 
and the cumulative result is used to balance the ASP. 


Select an Auxiliary Storage Pool that you want the system to monitor. The system 
will record all of the I/O activity on the disk units in that ASP. For example to 
start a trace on ASP 4 which will run for 35 minutes, enter the following 
command: TRCASPBAL ASP(4) SET(*ON) TIMLMT(35). 


If you want to end a trace before the time limit requested on the Start Trace is 
reached, use the Trace ASP Balance (TRCASPBAL) command. For example, if you 
want to end the trace on ASP 4, enter the following command: TRCASPBAL 
ASP(4) SET(*OFF). 


The collected statistics on each disk units I/O activity can be cleared by use of the 
TRCASPBAL command. You can clear old trace data if you do not want that data 
to be used in determining the locations of the high-use and low-use data on the 
disk units in the ASP. Use the Trace ASP Balance (TRCASPBAL) command to clear 
the trace data. For example, if you want to clear the trace data which has been 
collected from ASP 4, enter the following command: TRCASPBAL ASP(4) 
SET(*CLEAR). 


Determining adequate disk storage 


If you need to know how much disk storage is available on your system, use the 
Work with System Status (WRKSYSSTS) command. 


1. Type WRKSYSSTS at the command line. The Work with System Status display 
appears. 
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2. Record the values that are shown for System ASP and % system ASP used. 


3. Use those values in the formula that is shown below to calculate the available 
free space on your system: 


System ASP x (100 - % system ASP used) x 0.01 = Available disk storage 
If the amount of storage is less than you need to complete your task, you must 


create more disk space. You can create more space by adding additional disk units 
or by cleaning your system of files and programs you no longer use. 
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Part 8. Backup and Recovery Tools and Techniques 
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Chapter 25. Techniques and Programming Examples for 
Backup and Recovery 


This chapter includes several different techniques that you can use to assist with 
and manage your backup and recovery processes. 


Job Recovery Considerations 


Job recovery and starting again should be a basic part of application design. 
Applications should be designed to handle: 


* Unexpected data problems, such as alphabetic data occurring where numeric 
data is expected 


* Operator problems, such as operators taking the wrong option or canceling the 
job 

¢ Equipment problems, such as workstation, disk unit, and communication line 
failures 


Job recovery procedures should ensure the integrity of the user’s data and allow 
for easy starting of the interrupted application. Journaling and commitment control 
can be used in application design to help in job recovery. Recovery procedures 
should be transparent to the end users. 


Interactive Job Recovery 


If you are running a data entry job or one that updates a single file, it is unlikely 
that you may need to plan an extensive recovery strategy. The operators can 
inquire against the file to determine which record was last updated and then 
continue from that point. 


To recover from inquire-only jobs, the workstation operators simply start where 
they left off. When using update transactions for many files, consider using a 
journal or commitment control. The system automatically recovers journaled files 
during the initial program load (IPL) following an abnormal end of the system, or 
during make available (vary on) processing of an independent ASP after an 
abnormal vary off. In addition, the journal can be used for user-controlled forward 
or backward file recovery. There are other object types in addition to database 
physical files that you can protect with journaling. See the Journal Management 
topic in the iSeries Information Center at 

http:/ /www.ibm.com/eserver/iseries/infocenter for more information. 


Commitment control, using the file changes recorded in the journal, provides 
automatic transaction and file synchronization. During job end, the system 
automatically rolls back file updates to the beginning of the transaction. In 
addition, the commitment control notify object can assist you in restarting the 
transaction. See the commitment control information in the Database topic of the 
iSeries Information Center at http://www.ibm.com/eserver /iseries/infocenter for 
more information. 


When designing an interactive application, consider the possibility that you can 
experience equipment problems with your workstations and communications lines. 
For example, suppose your computer system loses power. If you have an 
uninterruptible power supply installed to maintain power to the processing unit 
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and disk units, your system remains active. However, in this example, your 
workstations lost power. When your programs attempt to read or write to the 
workstations, an error indication is returned to the program. If the application is 
not designed to handle these errors, the system can spend all its time in 
workstation error recovery. 


You should design your interactive applications to look at error feedback areas and 
handle any errors indicated. If the application handles the errors and stops, the 
system resource is not used to do nonproductive error recovery. Examples of using 
error feedback areas and error recovery routines can be found in the programming 
languages reference manuals. 


Batch Job Recovery 


Print-only batch jobs normally do not need special recovery to start again. Running 
the program again may be adequate. 


Batch jobs that perform file updates (add, change, or delete actions) present 
additional considerations for starting again and recovery. One approach to starting 
again is to use an update code within the record. As a record is updated, the code 
for that record can also be updated to show that processing for that record is 
complete. If the job is started again, the batch program positions itself (as a result 
of the update code) to the first record that it had not processed. The program then 
continues processing from that point in the file. 


Another way to start batch processing again is to save or copy the file before 
starting the job. You can use one of the following commands to save or copy the 
file: 

* Save Object (SAVOBJ) 

* Copy File (CPYF) 


Then, if you have to start again, restore or copy the file to its original condition 
and run the job again. With this approach, you need to ensure that no other job is 
changing the files. One way to ensure this is to get an exclusive lock on the file 
while the job is running. A variation of this approach is to use the journal. For 
example, if starting again is required, you could issue the Remove Journal Change 
(RMVJRNCHG) command to remove changes to the files. Then, run the job again 
against the files. 


If your batch job consists of a complex input stream, you probably want to design 
a strategy for starting again into the input stream. Then, if the batch job needs to 
be started again, the job determines from what point the stream continues. 


Commitment control also can be used for batch job recovery. However, if you plan 
to use commitment control for batch jobs, consider that the maximum number of 
record locks allowed in a commit cycle is 4 000 000. Therefore, you may need to 
divide the batch job into logical transactions. For example, if your batch program 
updates a master file record followed by several detail records in another file, each 
of those sets of updates can represent a logical transaction and can be committed 
separately. Locks are held on all records changed within a commit cycle. Therefore, 
changed data is made available more quickly if your batch job is divided into 
small, logical transactions. 


Journaling can also be used to assist in batch job recovery just as it can be for 
interactive jobs. See the Journal Management topic in the iSeries Information 


Center (http://www.ibm.com/eserver/iseries/infocenter) for more information. 
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Considerations for Using Save Files 


Using a save file allows you to save and restore objects without first placing save 
media into your save media device. You can also use a save file to send objects 
from one iSeries server to another over communications lines. You can use the save 
file as an online container to save the contents of a single library to run overnight. 
The next day, save the contents of the save file to storage media with the Save 
Save File Data (SAVSAVFDTA) command. Objects saved to a save file can be 
restored directly from save media, using the RSTLIB or RSTOBJ command. 


Among the items to consider for using save files are: 
* Performance 

* Storage capacity 

* Preparing save files for use 


At V5R2 you have three choices for software compression when saving to save 
files. If you choose a higher form of compression, your save will take longer, but 
the resulting save data will usually be smaller. The software compression choices 
are available through the Save Object (QsrSave) and Save Object List (QSRSAVO) 
APIs. 


You cannot save or send a save file that is larger than the target release allows. 


Performance When Using Save Files: Performance can vary, depending on other 
disk activity. Save files can be created on or moved to an ASP for improved 
performance and additional protection from system disk device failures. 


Save File Storage Capacity: The maximum capacity of a save file is about one 
terabyte. You can specify the maximum size of the save file on the Create Save File 
(CRTSAVF) command. 


Specify data compression on the save commands to reduce the space for the save 
file and the amount of media needed for the SAVSAVFDTA command. (Data 
compression is not an option on the SAVSAVFDTA command.) 


Preparing Save Files for Use: When saving to a save file that already contains data, 
use the Clear Save File (CLRSAVF) command or specify CLEAR(*ALL) on the save 
command, or reply to an inquiry message sent during the save operation. 


Saving the Save File Data: There are two ways to save the save file data: 

* With the SAVSAVFDTA command, only the data is saved. The description of the 
save file object is not saved. The save date and time of the save file are not 
updated. 

* When you use the Save Object (SAVOBJ) or the Save Library (SAVLIB) command 
with SAVFDTA(*YES) specified, both the object description and the data are 
saved. The save date and time are updated for the save file. 


Note: While you are saving save file data, other jobs cannot use the save file 
until the save operation completes unless you are using the 
save-while-active function. 


Determining the Contents of a Save File: You can use the Display Save File 


(DSPSAVF) command or the List Save File API to determine the contents of a save 
file. 
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The DSPSAVF command displays the contents of a save file. The information 
includes a description of each object saved and summary information. 


The List Save File (QSRLSAVF) API returns the contents of the save file in a user 
space. The contents of the save file is returned at a user-selected level of library 
information, object information, or member information. The QSRLSAVF API 
returns the same information that is shown on a DSPSAVF command. In addition, 
when you specify the SAVF0200 format, the system includes the following: 

* The serial number of the system on which the save operation was performed. 


* The ASP from which the object was saved. 


For more information about the QSRLSAVF API, click the Programming topic in 
the Information Center at the following Web site: 
http:/ /www.ibm.com/eserver /iseries /infocenter 


The QSYSINC library provides structures for the SAVF0100, SAVF0200, and 
SAVF0300 formats in C, COBOL, and RPG. 


Using Control Language (CL) Commands for Save Files 

Use the following CL commands with save files: 

* The Create Save File (CRTSAVF) command creates a save file that can be used 
with save and restore commands to store data. The save file stores data that 
would otherwise be written to save media. A save file can also be used as a 
container to send objects to another iSeries user on the systems network 
architecture distribution services (GNADS) network. 

* The Change Save File (CHGSAVF) command changes one or more of the 
attributes of a save file, such as the maximum number of records. 

* The Override Save File (OVRSAVF) command overrides or replaces certain 
attributes of a save file, or overrides any file with a save file. 

* The Display File Description (DSPFD) command displays the attributes of the 
save file. 

¢ The Clear Save File (CLRSAVF) command clears the contents of a save file. 

* The Display Save File (DSPSAVF) command displays the save and restore 
information in a save file, or the contents of the save file. 

* You can use the Save Object (SAVOBJ) or the Save Library (SAVLIB) command 
to save the description of the save file. You can also save the data to tape, 
diskette, optical media, or another save file in a different library. 

¢ The Save Save File Data (SAVSAVFDTA) command writes the contents of a save 
file to either tape, optical media, or diskette. 


Several commands used for save and restore operations also apply to save files. 


Save File Security 


The authority you grant for a save file is the same as for any file. Be careful when 
granting authority for save files. The authority you grant to the save file allows 
access to objects in the save file. For example, the same file can be read from and 
written to by a high-level language program. The authority you grant for a 
particular save file should depend on what objects are in the file. 


Consider the following factors when granting authorities to save files: 


* A user with use (*USE) authority can read records and restore objects from the 
save file. This user can save the contents of the save file to tape, optical media, 
or diskette. 
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* A user with use (USE) and add (*ADD) authority can write records and save 
objects in a save file. 


* A user with object operational (“OBJOPR) and object management (*OBJMGT) 
authority can clear the contents of a save file using the CLRSAVF command. The 
clear operation is required first when replacing existing records in a save file. 


* Auser with either save system (*SAVSYS) special authority or object existence 
(*OBJEXIST) authority for the file can save the description and contents. 


Digital signature for a save file 


Starting with VSR1MO you can put a digital signature on a save file. The system 
verifies any digital signatures present on the save file each time you display the 
save file or use the save file in a restore operation. If the signature is not valid you 
cannot display or use the save file in a restore operation. The Verify Object on 
Restore (QVFYOBJRST) system value does not affect the verification of save files. 
Therefore the system verifies the signature every time you display the save file or 
use the save file in a restore operation. 


For more information about digital signatures, click the Security topic in the 
Information Center at the following Web site: 


http://www. ibm.com/eserver/iseries/infocenter 


Opening a Save File 
The following considerations apply when opening a save file: 


* Parameters specified in the file are overridden with parameters specified in the 
program. Program-specified parameters are overridden with parameters on the 
OVRSAVF command. 


* The fewer parameters specified in the program and on the OVRSAVF command, 
the faster the file is opened. 


* If no record length is specified in the high-level language program that opens 
the file, a length of 528 bytes is assumed. If the program specifies a record 
length value, it must be 528. 


* For an input file, if the relative record number specified for the parameter does 
not exist in the file, an error message is sent and the file is not opened. 


* If you do not specify EXTEND(*YES) for a save file opened for output, the save 
file must be empty. If the save file is not empty, you receive an inquiry message 
to clear the file or cancel the operation. The file can only be cleared if the job 
trying to open the file has operational and object management authority. You can 
use the CLRSAVF command before the file is opened to ensure that it is empty 
and to avoid the inquiry message. 


* If asave file is open for output or is being used in a save or restore operation, 
another program or job cannot open it. 


* A save file can be opened by more than one program or job for input. While it is 
in use, the save file cannot be opened for output. 


Input and Output Operations on a Save File 
The following considerations apply to input and output operations on a save file: 


* Records are always read and written sequentially. The records read from a save 
file contain sequence and parity information that is validated when the records 
are written into another save file. This information ensures that the records are 
processed in sequence and have not been changed. 
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You cannot write a record that has changed since it was retrieved from another 
save file. You cannot write a record that is not the next record in sequence. If 
you attempt either or these, an escape message is sent to report the error. 


* A read of records from the save file can be done only if the entire file has been 
written. 


* The force-end-of-data (FEOD) function is valid for both input and output. 


For an input file, FEOD signals end-of-file to the program that does the 
operation. 


To ensure buffered output records are not lost after an FEOD operation 
completes, they are written to the file. For an output file, buffered output 
records are not lost even if the job or system fails. 


File-Dependent Attributes for a Save File 
Following are the file-dependent attributes for a save file: 
* The following file-dependent attributes apply when the save file is open: 


— For input operations, the first record returned for a read operation is the one 
specified by the parameter POSITION when the file is opened. After the first 
record is read, all remaining records are returned sequentially to the end of 
the file. 


— For output operations, new records can be added to the end of records 
already in the file (specified using the EXTEND parameter). Each save file 
record contains sequencing information used by the system to ensure that a 
record is not skipped or written more than once. 


— If no record length is specified in the high-level language program that opens 
the file, a length of 528 bytes is assumed. If the program specifies a record 
length value, it must be 528 bytes. 


* No file-dependent parameters (such as format name) can be specified for read or 
write operations with a save file. Any file-dependent parameters specified are 
ignored. 


Damage to a Save File 


A save file is marked partially damaged if an attempt to read a record or restore an 
object from the file encounters an auxiliary storage error. You can restore objects 
from a partially damaged save file other than the objects on the damaged part of 
auxiliary storage. The objects on the damaged portion of the auxiliary storage 
within the save file cannot be restored. When a file is marked partially damaged, 
you cannot add more records to it until it is cleared. 


Partial damage of the save file itself can occur that is unrelated to auxiliary storage 
errors. Sometimes a partial damage message is issued during a SAVSAVFDTA 
when the system is very busy. This can happen because an internal operation did 
not complete within a given time interval. It is most often seen when the 
SAVSAVFDTA job is running at a low priority and there is a heavy interactive load 
on the system. Although a SAVSAVFDTA can no longer be done from that save 
file, the objects in the SAVF can be restored to the system using RSTOBJ. 


Clearing a Save File 


Clearing a save file releases the auxiliary storage allocation to reduce the size of 
the object, and resets the partial damage mark on the file if it was previously 
marked damaged. A save file is cleared in one of two ways: 


* By using the CLRSAVF command prior to the save operation. 


480 0S/400 Backup and Recovery V5R2 


* By specifying CLEAR(*ALL) as the first part of a save operation to the save file. 
If CLEAR(*ALL) is not specified and emptied, a message is sent asking whether 
or not you want to clear the file. 


Sending Network Files 


The only objects you can send with the Send Network (SNDNETF) command are 
database file members or save files. The SNDNETF command creates a save file 
and copies the information into it. Once the file has been received using the 
Receive Network File (RCVNETF) command, the copy on the source system is not 
saved. Consider backing up the information on the remote system. 


Other objects (such as programs or commands) must be saved in a save file before 
they can be sent using the SNDNETF command. 


Note: Do not use save files to save objects on a system at the current release to 
distribute them to a system at a previous release unless TGTRLS(*PRYV) is 
specified on the save command. You may also specify TGTRLS(VxRxMx) on 
the save command, where (VxRxMx) is the previous-release-value. The 
current release to previous release rules still apply. 


Programming Examples for Backup and Recovery 


Following are several examples of programs for working with backup and 
recovery. 


Retrieving the Device Name from Save Completion Messages 


The CL program in retrieves the device name from the CPC3701 message 
(found in positions 126 through 135 of the message data) and uses the information 
to determine which device is used by the next save command. 


SEQNBR *... ... Ls rae - sexes 2 aise eee 3 esse. wk Be es. 658 BP saiere» fons 6 eae eas 7 

1.00 PGM 

2.00 DCL &MSGDATA *CHAR LEN(250) 

3.00 DCL &MSGID *CHAR LEN(7) 

4.00 DCL &DEV *CHAR LEN(10) 

5.00 DCL &DEV1 *CHAR LEN(10) VALUE(TAPO1) 

6.00 DCL &DEV2 *CHAR LEN(10) VALUE(TAPO2) 

7.00 SAVLIB LIB(LIB1) DEV(&DEV1 &DEV2) ENDOPT(*LEAVE) 

8.00 LOOP: RCVMSG RMV(*NO) MSGDTA(&MSGDATA) MSGID(&MSGID) 

9.00 IF (&MSGID *NE CPC3701) GOTO LOOP /* Compltn «/ 
10.00 CHGVAR &DEV %SST(&MSGDATA 126 10) /* Device name */ 
11.00 IF (DEV *EQ 'TAPO1') DO /* Last was TAPO1  */ 
12.00 CHGVAR &DEV1 'TAPO1' /* Set for first device */ 
13.00 CHGVAR &DEV2 'TAPO2' /* Set for second device */ 
14.00 ENDDO /* Last was TAPO1 */ 

15.00 ELSE DO /* Last was not TAPO1 */ 

16.00 CHGVAR &DEV1 'TAPO2' /* Set for first device */ 
17.00 CHGVAR &DEV2 'TAPO1' /* Set for second device */ 
18.00 ENDDO /* Last was not TAPQ1 */ 

19.00 SAVLIB LIB(LIB2) DEV(&DEV1 &DEV2) /* Save Lib 2 */ 
20.00 ENDPGM 


Figure 32. Program for Save Completion Messages 


If any objects cannot be saved, the operation attempts to save remaining objects 
and sends an escape message (CPF3771 for single libraries, CPF3751/CPF3778 for 
more than one library, and CPF3701 for save operations to save files) stating how 
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PGM 
SAVLIB 
MONMSG 


SNDPGMMSG 
SNDPGMMSG 
RETURN 


ENDDO 
ENDPGM 


many objects were saved and how many were not. To continue with the next 
library, the Monitor Message (MONMSG) command must be used to handle the 
escape condition. The format of the message data for the CPF3771 message is 
similar to the CPC3701 message and also identifies the last device used. 


The SAVCHGOBJ command operates in a similar manner, but uses CPC3704 as a 
completion message, CPF3774 as an escape message for single libraries, and 
CPC3721 or CPF3751 for multiple libraries. For save operations to save files, these 
messages are CPC3723 as a completion message and CPF3702 as an escape 
message. These messages also contain the last device or save file used in the 
message data. 


Displaying Status Messages When Saving 
[Figure 33|shows a program that sends a message to the external (*EXT) program 


message queue if any objects cannot be saved. 


/* SAVE SOURCE */ 
LIB(SRCLIB) DEV(TAPE@1) PRECHK(*YES) 
MSGID(CPFO000) EXEC (DO) 


MSG('Objects were not saved - Look at the job + 
log for messages') TOPGMQ(*EXT) 

MSG('SRCLIB library was not backed up') + 
TOPGMQ (xxxx) 


Figure 33. Program for Saving Source Files 


Using the Retrieve Journal Entry (RTVJRNE) Command in a 
Program 


Use the Retrieve Journal Entry (RTVJRNE) command in a control language 
program to retrieve a journal entry and place it in variables in the program. You 
can retrieve the following: 


* Sequence number 

¢ Journal code 

* Entry type 

¢ Journal receiver name 

* Library name for the journal receiver 
* Journal entry-specific data 


For example, you can use this command to automate your recovery procedures or 
to change the journal receivers and then save them. 


In|Figure 34 on page 483} the RTVJRNE command determines when job 


000666 /QPGMR/WORKSTO01 last opened file ORDENTP: 
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PGM 

DCL &SEQ#; TYPE(*DEC) LEN(10 0) 

DCL &JRNE TYPE(*CHAR) LEN(200) 

DCL &DATE TYPE(*CHAR) LEN(6) 

DCL &TIME TYPE(*CHAR) LEN(6) 

RTVIRNE JRN(DSTURN/JRNLA) FILE(DSTPRODLIB/ORDENTP) + 
RCVRNG(DSTJRN/RCV30 DSTIRN/RCV27) FROMENT (*LAST) + 
TOENT(*FIRST) SEARCH(*DESCEND) + 
JRNCDE(F) ENTTYP(OP) JOB(000666/QPGMR/WORKSTO1) + 
RTNSEQNBR(&SEQ#) ; RTNURNE(&JRNE) 

CHGVAR &DATE (%SST(&JRNE 19 6)) 

CHGVAR &TIME (%SST(&JRNE 25 6)) 

ENDPGM 


Figure 34, Program for Retrieving Journal Entries 


CL Program to Handle Escape Conditions 


You normally use the APYJRNCHG command to perform file recovery. However, 
usable journal receivers are needed to successfully use this command. If usable 
journal receivers are not found, an escape message is sent. 
demonstrates how this escape condition can be handled in a CL program by 
prompting for restoration of the required receiver. This example uses database files. 
You can extend this example to use the APYJRNCHG command with all object 
types that support journaling. 
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FILERECOV: PGM 


APYJRNCHG JRN(JRNLIB/JRNA) FILE((LIBA/FILEA)) + 
RCVRNG(RCVLIB/RCV1 *CURRENT) 
MONMSG MSGID(CPF7053 CPF9801) + 
EXEC(CALL PGM(FIXLIB/RSTRCV) PARM(FILERECOV) ) 


ENDPGM 


RSTRCV: PGM PARM(&PGMNM) 


/* Recover a nonexistent or unusable receiver */ 
/* in RCVRNG by prompting for a restore of x/ 
/* receiver. 
DCL *PGMNM TYPE(*CHAR) LEN(10) /* name of program */ 
/* calling RSTRCV */ 
/* that received x*/ 
/* CPF7053 or */ 
/* CPF9801 */ 
DCL &MSGDATA TYPE(*CHAR) LEN(22) /* variable for  */ 
/* CPF7053 or */ 
/* CPF9801 «/ 
DCL &MSGDID TYPE(*CHAR) LEN(7) /* escape message */ 
/* ID */ 
DCL &RCVNAME TYPE(*CHAR) LEN(10) /* name of */ 
/* receiver to */ 
/* restore */ 
DCL &RCVLIB TYPE(*CHAR) LEN(10) /* library name */ 
/* of receiver to */ 
/* restore x/ 
DCL &RCODE TYPE(*CHAR) LEN(2) VALUE(x'0001') 
/* reason code 1 of CPF7053 */ 


RCVMSG PGMQ(*SAME &PGMNM) MSGTYPE(*EXCP) WAIT(0) + 
RMV(*NO) MSGDTA(&MSGDATA) MSGID(&MSGID) 


Figure 35. Example Program Prompts for Restoring the Required Receiver For an APYJRNCHG (Part 1 of 2) 
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IF COND(&MSGID *EQ 'CPF98Q1') THEN(DO)  /* CPF9801 occurred */ 
CHGVAR &RCVNAME(%SST(&MSGDATA 1 10)) /* get receiver */ 


/* from message x/ 
/* data */ 
CHGVAR &RCVLIB (%SST(&MSGDATA 11 10))  /* get library x/ 
/* name from */ 
/* message data */ 


2? RSTOBJ OBJ(&RCVNAME) SAVLIB(&RCVLIB) OBJTYPE(*JRNRCV) 
/* display RSTOBJ prompt */ 
ENDDO 
ELSE DO 
IF COND((&MSGID *EQ 'CPF7053') & (%SST(&MSGDATA 1 2) + 
*EQ &RCODE)) THEN(DO) /*CPF7053 RC(1) occurred*/ 
CHGVAR &RCVNAME (%SST(&MSGDATA 3 10)) /* get receiver x*/ 


/* name from */ 
/* message data */ 
CHGVAR &RCVLIB (%SST(&MSGDATA 13 10)) /* get library */ 
/* name from */ 
/* message data */ 


? RSTOBJ OBJ(&RCVNAME) SAVLIB(&RCVLIB) OBJTYPE(*JRNRCV) 
/* display restore prompt */ 
ENDDO 
ELSE 


ENDDO 
ENDPGM 


Figure 35. Example Program Prompts for Restoring the Required Receiver For an APYJRNCHG (Part 2 of 2) 


Writing output to save media using the receive journal entry 
command 


Note: You may want to consider using the remote journal function to transfer your 
journal receiver data to another server instead of the following. See the 
Journal Management topic in the iSeries Information Center 
(http:/ /www.ibm.com/eserver/iseries/infocenter) for more information. 


shows an RPG program that is being used as the exit 
program for the Receive Journal Entry (RCVJRNE) command. This example writes 
putput onto tape media, See Tournal Entries Written to an ICF Fle” on page 45 
for a discussion of changing the sample to write output to an OS/400-ICF file. See 
the Journal Management topic in the iSeries Information Center 


(http:/ /www.ibm.com/eserver/iseries/infocenter) for a discussion of how to use 
the RCVJRNE command. 
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SEQNBR *... ... Th Asie. ears 2 hee: oaebte 8 weave «ays Dinas eras Bauer tes ante Or esis wise 7 

1.00 FTAPE 0 oF 300 SEQ 

2.00 IJRNENT DS 300 

3.00 I 1 = 50J0ENTL 

4.00 C *ENTRY PLIST 

5.00 ¢ PARM JRNENT 

6.00 C PARM CALLCD 1 

7.00 C CALLCD  IFEQ '1' Entry rcvd 

8.00 Cx Ensure journal entry is not being truncated 

9.00 C JOENTL  CABGT300 RETURN H1 If GT output 
10.00 Cc ADD 1 OUTRCD 70 Bump ctr 
11.00 C EXCPTOUTPUT Output 
12.00 C END Entry rcvd 
13.00 C CALLCD IFEQ '0' Rdy to wait 
14.00 Cc EXSR FORCE Force out 
15.00 C END Rdy to wait 
16.00 C SHTDN 31 Test shtdwn 
17.00 ¢ 31 DO If shtdwn 
18.00 C EXSR FORCE Force out 
19.00 C MOVE '9' CALLCD Set to end 
20.00 ¢ SETON LR Set LR 
21.00 C END If shtdwn 
22.00 C RETURN TAG Return tag 
23.00 C RETRN Return 
24.00 C FORCE BEGSR Force out 
25.00 ¢ QOUTRCD IFNE *ZERO If rcds 
26.00 C FEOD TAPE FEOD 

27.00 C Z-ADDO OUTRCD Reset 
28.00 C END If rcds 
29.00 C ENDSR End subr 
30.00 OTAPE E OUTPUT 

31.00 0 JRNENT 


Figure 36. Program for writing RCVJRNE output to save media 


Considerations When Writing to Tape 

A separate job must be in continuous operation and dedicated to converting entries 
to tape. Before issuing the RCVJRNE command, your job should issue an 
OVRTAPF command, specifying fixed-length blocked records, to direct the RPG file 
TAPE to a tape device. 


You should not consider this approach with a streaming tape device. A user 
auxiliary storage pool (ASP) is a preferred solution instead of a tape. However, this 
approach is similar to writing journal entries to a communications line. 


The RPG program is written assuming that the largest journal entry to be passed is 
300 bytes. This is the size that is given to the data structure JRNENT. It allows a 
record size of 175 bytes plus the 125 bytes of journal entry identifier information 
and qualifier information. A check is made in the program to ensure that the 
record image is not being truncated: 


* If a code of 1 is passed from the RCVJRNE command, the program ensures that 
the journal entry does not exceed 300 bytes. If it does, the program sets on the 
H1 indicator and returns. The program adds 1 to the counter and writes the 
record to the tape output file. Because this is an output-only file, RPG 
automatically blocks the records within the RPG program. 


When full, the block is passed to tape data management, where additional 
blocking can occur and double-buffering to the tape device is provided. This 
ensures that the tape performance is optimal. Because the records are not written 
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directly to tape when the program requests the output, there can be some 
interval of time before the records are written to the external media. 


* When a code of 0 is passed from the RCVJRNE command, no more entries exist 
in the journal. On the return to the RCVJRNE command, the DELAY parameter 
value specified on the RCVJRNE command is used to wait before checking for 
additional entries. To avoid keeping the records in the various buffers while the 
delay occurs, the program forces the records to the tape device by using the 
force end-of-data operation (FEOD). 


This causes all records in either the RPG or tape data management buffers to be 
written to the tape device, and a device completion notification to be received 
before proceeding to the next instruction. If there is less than a full block of 
records, a short block is written to tape. Tape data management correctly 
handles the short block if the tape is read in a subsequent program. When the 
return occurs to the RCVJRNE command, the delay time occurs whether or not 
any journal entries have arrived since the last time the exit program was called. 


The RPG program increments a counter each time a record is written and resets it 
when the FEOD operation is used. The program issues the FEOD operation only if 
a record has been written which avoids calling tape data management when there 
are no records to be written. (If tape data management has no records in its buffers 
when the FEOD operation occurs, no empty block is written, but system overhead 
occurs.) 


The RPG program uses the SHTDN operation code to check for requests to end the 
job from external functions such as an End Job (ENDJOB) or End Subsystem 
(ENDSBS) command with OPTION(*CNTRLD). If end-of-job is requested, the 
program forces the records from the buffers, sets the counter to 9 (which tells the 
RCVJRNE command to complete normally, and sets the LR indicator on). The 
RETRN operation is then issued and: 


* If LR is on, the program’s working storage is returned to the system. 


* If LR is off, the program remains active and waits to be called again by the 
RCVJRNE command. 


Writing to tape occurs either by the buffers being full or when the FEOD operation 
is used. This trade-off allows good performance when many journal entries are 
written and minimizes the number of times the FEOD operation is used to ensure 
that the entries are actually on the tape. With the sample program, the value of the 
DELAY parameter and the work management specifications for your job (for 
example, pool size and priority) are the major factors controlling the frequency 
with which the entries are written and the performance implications on the system 
for this function. 


If the system ends abnormally while the job is running, so that a successful 
end-of-file indication is not written, the subsequent reading of the tape can 
produce results that cannot be predicted. Blocks that were successfully written can 
be correctly read. The last block and any subsequent data that is on the tape from 
a previous use can produce results that cannot be predicted. Copy the tape to a 
database file and examine the contents before using the data. 


The journal sequence numbers are in ascending sequence (unless they have been 


reset) and can be used to determine where the logical end-of-file exists. To avoid 
confusion, delete the tapes used for this type of approach. 


Assume, for example, that the largest record size journaled was 175 bytes and the 
tape record size 300 bytes, as in|Figure 36 on page 486] If you need to increase the 
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tape record size, change the value of 300 in the RPG file description specification, 
the input specification, and factor 2 of the CABGT operation code. If there are 
some significantly larger records being journaled, consider how much excess media 
is used. An alternative would be to examine the individual fields ((OENTL) and 
write two or more small records for each large record. 


Journal Entries Written to an ICF File 
This topic discusses the differences in programming when you use an ICF file 


instead_of a tape file as output for the RCVJRNE command. Refer to the program 
in |Figure 36 on page 486 


If you use an ICF file to transmit journal entries to another system, the FEOD 
operation does not apply. Instead, there are data description specifications (DDS) 
words (for example, FRCDTA) to force records from the buffers. 


Usually the number of blocks transmitted to tape by records less than 175 bytes is 
a minimal performance consideration. On communications lines, however, this 
number can be significant. To avoid sending unnecessary trailing blanks, consider 
decreasing the length of the record being transmitted by the variable length 
function (VARLEN DDS keyword). For a discussion of the variable length function, 
see the Intrasystem Communications Programming. 


If binary synchronous equivalence link (BSCEL) is used, trailing blanks will be 
truncated automatically if the TRUNC parameter is specified on the Add ICF 
Device Entry (ADDICFDEVE) or the Override ICF Device Entry (OVRICFDEVE) 
command. Refer to the BSC Equivalence Link Programming book for more 
information about the function of the TRUNC parameter. 
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Appendix A. Licensed Internal Code Installation Error Screens 


One of the following three screens may be displayed if you chose option 1 (restore) 
on the install selection menu and the selected disk is not currently a load source 
disk. In this case, the restore cannot be done. If the selected disk is the correct one 
to install to, return to the selection menu and choose the correct install option 2, 3, 
4, or 5 to initialize the disk and perform an installation. If the selected disk is not 
the correct one, or if an existing load source disk should have been found, follow 
the appropriate procedures to determine why the correct disk did not report in, or 
was not recognized. 


If there is information about a missing disk(s) (second or third of the following 
three screens), it indicates what the last load source disk was on this system. If that 
disk should still exist (it has not been removed or replaced), determine why it was 
not found. If that disk has been removed or replaced, then this is just informational 
and may not indicate an error. 


\ 
Restore Licensed Internal Code 
Disk selected to write the Licensed Internal Code to: 
Serial Number Type Model I/0 Bus Controller Device 
The disk selected has not previously been a load source. The 
restore of the Licensed Internal Code cannot be done. 
Press Enter to return to the Install Licensed Internal Code 
screen. 
yo 
( = 
Restore Licensed Internal Code 
Disk selected to write the Licensed Internal Code to: 
Serial Number Type Model 1/0 Bus Controller Device 
The load source disk could not be found (see disk information 
below). 
Missing load source disk: 
Serial Number Type Model I/0 Bus Controller Device 
The disk selected has not previously been a load source. The 
restore of the Licensed Internal Code cannot be done. 
Press Enter to return to the Install Licensed Internal Code 
screen. 
/ 
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a > 


Restore Licensed Internal Code 


Disk selected to write the Licensed Internal Code to: 
Serial Number Type Model 1/0 Bus Controller Device 


The load source disk and its mirrored pair could not be found 
(see disk information below). 


Missing load source disk: 
Serial Number Type Model 1/0 Bus Controller Device 


The disk selected has not previously been a load source. The 
restore of the Licensed Internal Code cannot be done. 


Press Enter to return to the Install Licensed Internal Code 
screen. 


yy 


The following screen can be displayed if you chose option 1 (restore) on the install 
selection menu, but the release level of the Licensed Internal Code on the install 
media cannot be restored over the current release level on disk. Verify that you 
have the correct install media (version/release/modification level). If the level is 
correct, then you must do an initialize and install to get the new LIC installed over 
the existing LIC on the disk. 

( = 


Restore Licensed Internal Code 


Disk selected to write the Licensed Internal Code to: 
Serial Number Type Model 1/0 Bus Controller Device 


The release level of the Licensed Internal Code on the distribution 
media cannot be restored over the existing release level on the 
selected disk. 


Press Enter to return to the Install Licensed Internal Code 
screen. 


ey 


The following screen can be displayed if you chose option 1 (restore) on the install 
selection menu and the selected disk is currently a load source disk, but the 
pertinent data on the disk cannot be read and, therefore, a restore cannot be done. 
You must do an initialize and installation to install the new LIC on this disk. 

(e A 


Restore Licensed Internal Code 


Disk selected to write the Licensed Internal Code to: 
Serial Number Type Model 1/0 Bus Controller Device 


The selected disk cannot be read. The restore of the Licensed 
Internal Code cannot be done. 


Press Enter to return to the Install Licensed Internal Code 
screen. 
X 


The following screen can be displayed if two load source disks are detected on 
your system. The best disk was selected for the restore or installation. The data 
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about the other disk is informational so you can verify that the correct disk was 
selected. If the correct disk was not selected, follow the appropriate procedures to 
disable or remove the selected disk, so that the other disk is selected when you 


rerun the task. 
(a >) 


Install Licensed Internal Code - Warning 


Disk selected to write the Licensed Internal Code to: 
Serial Number Type Model 1/0 Bus Controller Device 


Warning: 
Another load source disk has also been found on this system. 
If you continue the restore or install, the disk listed 
above will be used. 


Additional load source disk: 
Serial Number Type Model I/0 Bus Controller Device 


Press Enter to continue the restore or install on the selected 
disk. 


ee 


The following screen is displayed if mirroring is active but one disk of the load 
source mirrored pair cannot be found. The restore or installation can still continue 
on the selected disk, but will not be mirrored until the missing disk becomes again 
active. You may want to follow the appropriate procedures to determine why one 
of the disks were not found. 


@ >) 


Install Licensed Internal Code - Warning 


Disk selected to write the Licensed Internal Code to: 
Serial Number Type Model 1/0 Bus Controller Device 


Warning: 
The mirrored unit for this load source was not found (see 
disk information below). The restore or install can continue 
on the selected load source. The missing mirrored unit will 
be suspended when the restore or install is complete. 


Missing load source disk: 
Serial Number Type Model 1/0 Bus Controller Device 


Press Enter to continue the restore or install on the selected 
disk. 
ne 


es 


The following two screens are displayed if the disk selected for the install to is not 
the same disk that was previously the load source on this system. If the missing 
disk should still exist (it has not been removed or replaced), determine why it was 
not found. If the disk was removed or replaced, this data is just informational and 
may not indicate an error. 
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Install Licensed Internal Code - Warning 


Disk selected to write the Licensed Internal Code to: 
Serial Number Type Model 1/0 Bus Controller Device 


Warning: 
The load source disk could not be found (see disk information 
below). 


Missing load source disk: 
Serial Number Type Model 1/0 Bus Controller Device 


Press Enter to continue the initialize and install on the 
selected disk. 
S 


S 
a j >) 
Install Licensed Internal Code - Warning 
Disk selected to write the Licensed Internal Code to: 
Serial Number Type Model 1/0 Bus Controller Device 
Warning: 
The load source disk and its mirrored pair could not be found 
(see disk information below). 
Missing load source disk: 
Serial Number Type Model 1/0 Bus Controller Device 
Press Enter to continue the initialize and install on the 
selected disk. 
sd / 


The following screen is displayed if mirroring is active and the active load source 
disk can not be found. One unit of the load source mirrored pair was found but is 
not currently active. You can install to it, but you will not be allowed to IPL past 
DST with it. You may want to follow the appropriate procedures to determine why 
the active load source disk can not be found. 


(a > 


Install Licensed Internal Code - Warning 


Disk selected to write the Licensed Internal Code to: 
Serial Number Type Model 1/0 Bus Controller Device 


Warning: 
A load source disk could not be found (see disk information 
below). 
The disk selected to be the load source (see above) is 
suspended. You may install to it and perform an IPL from it to 
get to DST and perform DASD diagnostics. However, you will not 
be able to perform an IPL past DST with it. 


Missing load source disk: 
Serial Number Type Model 1/0 Bus Controller Device 


Press Enter to continue the restore or install on the selected 
disk. 
Xe 
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One of the following three screens is displayed if no disk can be found. That is, no 
disk reported in, or was recognized by the system. 


If information is supplied about a missing disk(s) (second and third of the three 
screens), it indicates what was the last load source disk on this system. If that disk 
should still exist (it has not been removed or replaced), then determine why it was 
not found. If that disk has been removed or replaced, then this data is just 
informational and may not be the reason for the error. 


a Y 


Install Licensed Internal Code - Error 


Error: 
A disk could not be selected to be the load source. 
You can return to the Dedicated Service Tools display and 
run diagnostics to determine why a disk could not be 
selected. 


Correct the problem and install the Licensed Internal Code 
again. 


Press Enter to return to the Dedicated Service Tools display. 


(a >) 


Install Licensed Internal Code - Error 


Error: 
The load source disk could not be found (see disk information 
below). 


Missing load source disk: 
Serial Number Type Model 1/0 Bus. Controller Device 


A disk could not be selected to be the load source. 

You can return to the Dedicated Service Tools display and 
run diagnostics to determine why a disk could not be 
selected. 


Correct the problem and install the Licensed Internal Code 
again. 


ee Enter to return to the Dedicated Service Tools display. 


Ne 


ia > 


Install Licensed Internal Code - Error 


Error: 
The load source disk and its mirrored pair could not be found 
(see disk information below). 


Missing load source disk: 
Serial Number Type Model 1/0 Bus Controller Device 


A disk could not be selected to be the load source. 

You can return to the Dedicated Service Tools display and 
run diagnostics to determine why a disk could not be 
selected. 


Correct the problem and install the Licensed Internal Code 
again. 


Rees Enter to return to the Dedicated Service Tools display. 


One of the following two screens is displayed if a disk is found, but it is not at a 
valid address to be the load source. 
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If there is information about a missing disk(s) (the second screen), it indicates what 
the last load source disk was on this system. If that disk should still exist (it has 
not been removed or replaced), determine why it was not found. If it has been 
removed or replaced, this is just informational and may not be the reason for the 


error. 
r >) 
Install Licensed Internal Code - Error 
Error: 
A disk was found, but it is not at a valid address to be the 
load source device. 
Selected disk: 
Serial Number Type Model 1/0 Bus Controller Device 
The install cannot be done. Press Enter to return to the Dedicated 
Service Tools display. 
Ne y 
ies YN 
Install Licensed Internal Code - Error 
Error: 
A disk was found, but it is not at a valid address to be the 
load source device. 
Selected disk: 
Serial Number Type Model 1/0 Bus Controller Device 
The following disk was a load source previously, but could not be 
found. 
Missing load source disk: 
Serial Number Type Model 1/0 Bus Controller Device 
The install cannot be done. Press Enter to return to the Dedicated 
Service Tools display. 
XQ A 


The following screen is displayed if an existing load source disk is found, but is 
not at a valid address to be the load source. If it was intentionally moved, 
determine why no other disk could be found to which to install. If this is the 


correct disk, determine why it is not at a valid address. 
ie >) 


Install Licensed Internal Code - Error 


Errors 
The following disk was a load source previously, but it is not 
currently at a valid address to be the load source device. 


Selected disk: 
Serial Number Type Model 1/0 Bus Controller Device 


The install cannot be done. Press Enter to return to the Dedicated 
Service Tools display. 


a 


The following screen is displayed if an existing load source disk was found and: 
* Is not at a valid address to be the load source. 
* Is one unit of a mirrored pair. 
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* Is currently not the active load source. 


Information about the previously active load source is also listed. If this load 
source should still be available to install to, use the appropriate procedures to 


determine why it could not be found. 
ie x 


Install Licensed Internal Code - Error 


Error: 
The following disk was a load source, but it is not currently 
active, and it is not at a valid address to be the load source 
device. 


Selected disk: 
Serial Number Type Model 1/0 Bus Controller Device 


The following disk was the previously active load source, but it 
could not be found. 


Missing load source disk: 
Serial Number Type Model 1/0 Bus Controller Device 


The install cannot be done. Press Enter to return to the Dedicated 
Service Tools display. 
Ke yy 
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Appendix B. Example Disaster Recovery Plan 


The objective of a disaster recovery plan is to ensure that you can respond to a 
disaster or other emergency that affects information systems and minimize the 
effect on the operation of the business. This topic provides you with guidelines for 
the kind of information and procedures that you need to recover from a disaster. 
When you have prepared the information described in this topic, store your 
document in a safe, accessible location off site. 


Section 1. Major 


Goals of a Disaster Recovery Plan—Example 


The major goals of this plan are the following: 


To minimize interruptions to the normal operations. 
To limit the extent of disruption and damage. 

To minimize the economic impact of the interruption. 
To establish alternative means of operation in advance. 
To train personnel with emergency procedures. 


To provide for smooth and rapid restoration of service. 


Section 2. Personnel-Example 


Data Processing Personnel 


Name Position Address Telephone 
Data Processing Personnel 
Name Position Address Telephone 
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Data Processing Personnel 


Name Position Address Telephone 


Organization Chart 


Include a copy of the organization chart with your plan. 


Section 3. Application Profile-Example 
Use the Display Software Resources (DSPSFWRSC) command to complete this 


table. 

Application Profile 
Critical | Fixed Asset 

Application Name Yes/No | Yes / No Manufacturer Comments 
Comment Legend: 
1. Runs daily. 
2. Runs weekly on 
3. Runs monthly on 


Section 4. Inventory Profile-Example 


Use the Work with Hardware Products (WRKHDWPRD) command to complete 
this table: 
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Application Profile 


Serial Own or 
Manufacturer Description Model |Number | Leased Cost 
Notes: 
1. This list should be audited every months. 
2. This list should include: 
Processing units System printer 
Disk units Tape, optical devices, and diskette units 
Models Controllers 
Workstation controllers I/O Processors 
Personal computers General data communication 
Spare workstations Spare displays 
Telephones Racks 
Air conditioner or heater Humidifier or dehumidifier 
Miscellaneous Inventory 
Description Quantity Comments 
Note: This list should include: 
Tapes Diskettes 
PC software (such as DOS) Emulation packages 
File cabinet contents or documentation Language software (such as COBOL and RPG) 
Tape vault contents Printer supplies (such as paper and forms) 


Optical media 


Section 5. Information Services Backup Procedures 


e iSeries Server 


— Daily, journals receivers are changed at and at 


— Daily, a save of changed objects in the following libraries and directories is 


doneat_ 
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This procedure also saves the journals and journal receivers. 


- On at a complete save of the system is done. 


— All save media is stored off-site in a vault at location. 


* Personal Computer 


— It is recommended that all personal computers be backed up. Copies of the 
personal computer files should be uploaded to the iSeries server on 


(date) at (time), just before a complete save of 


the system is done. It is then saved with the normal system save procedure. 
This provides for a more secure backup of personal computer-related systems 
where a local area disaster could wipe out important personal computer 
systems. 


Section 6. Disaster Recovery Procedures 


For any disaster recovery plan, the following three elements should be addressed. 


Emergency Response Procedures 


To document the appropriate emergency response to a fire, natural disaster, 
or any other activity in order to protect lives and limit damage. 


Backup Operations Procedures 


To ensure that essential data processing operational tasks can be conducted 
after the disruption. 


Recovery Actions Procedures 


To facilitate the rapid restoration of a data processing system following a 
disaster. 


Disaster Action Checklist 


1. Plan Initiation 


a. Notify senior management 


ao 


e 
f. 
g. 
h. Contact vendors—both hardware and software 


Contact and set up disaster recovery team 
Determine degree of disaster 


Implement proper application recovery plan dependent on extent of 
disaster (see Section 7. Recovery Plan—Mobile Site 


. Monitor progress 


Contact backup site and establish schedules 
Contact all other necessary personnel—both user and data processing 


Notify users of the disruption of service 


2. Follow-Up Checklist 


“929 


List teams and tasks of each 


Obtain emergency cash and set up transportation to and from backup site, 
if necessary 


Set up living quarters, if necessary 

Set up eating establishments, as required 

List all personnel and their telephone numbers 
Establish user participation plan 
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g. Set up the delivery and the receipt of mail 

h. Establish emergency office supplies 

i. Rent or purchase equipment, as needed 

Determine applications to be run and in what sequence 


aiid 


. Identify number of workstations needed 


Check out any off-line equipment needs for each application 

m. Check on forms needed for each application 

n. Check all data being taken to backup site before leaving and leave 
inventory profile at home location 

. Set up primary vendors for assistance with problems incurred during 
emergency 

p. Plan for transportation of any additional items needed at backup site 


e) 


q. Take directions (map) to backup site 
r. Check for additional magnetic tapes, or optical media if required 


s. Take copies of system and operational documentation and procedural 
manuals. 


t. Ensure that all personnel involved know their tasks 


= 


Notify insurance companies 


Recovery Start-Up Procedures for Use after Actual Disaster 


1. Notify Disaster Recovery Services of the need to utilize service 
and of recovery plan selection. 


Note: Guaranteed delivery time countdown begins at the time 
is notified of recovery plan selection. 


a. Disaster notification numbers 


or 


These telephone numbers are in service from am until 
pm Monday through Friday. 


2. Disaster notification number 


This telephone number is in service for disaster notification after business 
hours, on weekends, and during holidays. Please use this number only for the 
notification of the actual disaster. 

3. Provide with an equipment delivery site address (when 
applicable), a contact, and an alternate contact for coordinating service and 
telephone numbers at which contacts can be reached 24 hours a day. 

4. Contact power and telephone service suppliers and schedule any necessary 
service connections. 

5. Notify immediately if any related plans should change. 


Section 7. Recovery Plan—Mobile Site 


1. Notify of the nature of the disaster and the need to select the 
mobile site plan. 
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co 


11. 


12. 


is. 
14. 


. Confirm in writing the substance of the telephone notification to 


within 48 hours of the telephone notification. 
Confirm all needed backup media are available to load the backup machine. 
Prepare a purchase order to cover the use of backup equipment. 


Notify of plans for a trailer and _its placement (on 
side of ). (See |“Mobile Site Setup Plan”}) 


Depending on communication needs, notify telephone company 
) of possible emergency line changes. 


. Begin setting up power and communications at 


a. Power and communications are prearranged to hook into when trailer 
arrives. 


b. At the point where telephone lines come into the building 
( ), break the current linkage to the administration 
controllers ( ). These lines are rerouted to lines going to the 
mobile site. They are linked to modems at the mobile site. 


The lines currently going from to would 
then be linked to the mobile unit via modems. 


c. This could conceivably require to redirect lines at 
complex to a more secure area in case of disaster. 


When the trailer arrives, plug into power and do necessary checks. 
Plug into the communications lines and do necessary checks. 


tem” on page 503). 


. Begin loading system from backups (see |“Section 9. Restoring the Entire 
{5ystem’” on page 53 


Begin normal operations as soon as possible: 
a. Daily jobs 

b. Daily saves 

c. Weekly saves 


Plan a schedule to back up the system in order to restore on a home-base 
computer when a site is available. (Use regular system backup procedures). 


Secure mobile site and distribute keys as required. 


Keep a maintenance log on mobile equipment. 


Mobile Site Setup Plan 


Attach the mobile site setup plan here. 


Communication Disaster Plan 


Attach the communication disaster plan, including the wiring diagrams. 


Electrical Service 


Attach the electrical service diagram here. 
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Section 8. Recovery Plan—Hot Site 


The disaster recovery service provides an alternate hot site. The site has a backup 
system for temporary use while the home site is being reestablished. 


14. 


1. 


Notify of the nature of the disaster and of its desire for a hot 
site. 
Request air shipment of modems to for communications. (See 


for communications for the hot site.) 


Confirm in writing the telephone notification to within 48 
hours of the telephone notification. 


Begin making necessary travel arrangements to the site for the operations 
team. 


Confirm that you have enough save media and that it is packed for shipment 
to restore on the backup system. 


Prepare a purchase order to cover the use of the backup system. 


Review the checklist for all necessary materials before departing to the hot 
site. 

Make sure that the disaster recovery team at_the disaster site has the necessary 
information to begin restoring the site. (See|Section 12. Disaster Site 
Rebuilding” on page 506). 

Provide for travel expenses (cash advance). 


After arriving at the hot site, contact home base to establish communications 
procedures. 


. Review materials brought to the hot site for completeness. 


Start to load the system from the save media. 
Begin normal operations as soon as possible: 
a. Daily jobs 

b. Daily saves 

c. Weekly saves 


Plan the schedule to back up the hot-site system in order to restore on the 
home-base computer. 


Hot-Site System Configuration 


Attach the hot-site system configuration here. 


Section 9. Restoring the Entire System 


Before You Begin: Find the following save media, equipment, and information from 
the on-site tape vault or the off-site storage location: 


If you install from the alternate installation device, you need both your save 
media and the CD-ROM media containing the Licensed Internal Code. 


All save media from the most recent complete save operation 
The most recent save media from saving security data (GSAVSECDTA or SAVSYS) 
The most recent save media from saving your configuration, if necessary 


All save media that contains journals and journal receivers that you saved since 
the most recent daily save operation 
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* All save media from the most recent daily save operation 


* PTF list (stored with the most recent complete save media, weekly save media, 
or both) 


* Save media list from most recent complete save operation 
* Save media list from most recent weekly save operation 

* Save media list from daily saves 

* History log from the most recent complete save operation 
* History log from the most recent weekly save operation 

* History log from the daily save operations 

* The Software Installation book 

* The Backup and Recovery book 

* Telephone directory 

* Modem manual 

* Tool kit 


Section 10. Rebuilding Process 


The management team must assess the damage and begin the reconstruction of a 
new data center. 


If the original site must be restored or replaced, the following are some of the 
factors to consider: 


* What is the projected availability of all needed computer equipment? 


* Will it be more effective and efficient to upgrade the computer systems with 
newer equipment? 


* What is the estimated time needed for repairs or construction of the data site? 


* Is there an alternative site that more readily could be upgraded for computer 
purposes? 


Once the decision to rebuild the data center has been made, go to}Section 12. 


Disaster Site Rebuilding” on page 506 


Section 11. Testing the Disaster Recovery Plan 


In successful contingency planning, it is important to test and evaluate the plan 
regularly. Data processing operations are volatile in nature, resulting in frequent 
changes to equipment, programs, and documentation. These actions make it critical 
to consider the plan as a changing document. 


(Table 77| should be helpful for conducting a recovery test. 
Table 77. Checklist for Testing the Disaster Recovery Plan 


Not 
Item Yes No | Applicable | Applicable | Comments 


Conducting a Recovery Test 
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Table 77. Checklist for Testing the Disaster Recovery Plan (continued) 


Item 


Yes 


No 


Applicable 


Not 
Applicable 


Comments 


10. 


Select the purpose of the test. What aspects of the 
plan are being evaluated? 

Describe the objectives of the test. How will you 
measure successful achievement of the objectives? 
Meet with management and explain the test and 
objectives. Gain their agreement and support. 
Have management announce the test and the 
expected completion time. 

Collect test results at the end of the test period. 
Evaluate results. Was recovery successful? Why or 
why not? 

Determine the implications of the test results. Does 
successful recovery in a simple case imply successful 


recovery for all critical jobs in the tolerable outage 
period? 

Make recommendations for changes. Call for 
responses by a given date. 


Notify other areas of results. Include users and 
auditors. 


Change the disaster recovery plan manual as 
necessary. 


Areas to be Tested 
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Table 77. Checklist for Testing the Disaster Recovery Plan (continued) 


Item 


Yes 


No 


Applicable 


Not 
Applicable 


Comments 


10. 


11. 


12. 


13. 


14. 


15. 


16. 
17. 
18. 


. Recovery of individual application systems by using 


files and documentation stored off-site. 


Reloading of system save media and performing an 
IPL by using files and documentation stored off-site. 


Ability to process on a different computer. 


Ability of management to determine priority of 
systems with limited processing. 


Ability to recover and process successfully without 
key people. 


Ability of the plan to clarify areas of responsibility 
and the chain of command. 


Effectiveness of security measures and security 
bypass procedures during the recovery period. 


Ability to accomplish emergency evacuation and 
basic first-aid responses. 


Ability of users of real-time systems to cope with a 
temporary loss of on-line information. 


Ability of users to continue day-to-day operations 
without applications or jobs that are considered 
noncritical. 


Ability to contact the key people or their designated 
alternates quickly. 


Ability of data entry personnel to provide the input 
to critical systems by using alternate sites and 
different input media. 


Availability of peripheral equipment and processing, 
such as printers and scanners. 


Availability of support equipment, such as air 
conditioners and dehumidifiers. 


Availability of support: supplies, transportation, 
communication. 


Distribution of output produced at the recovery site. 
Availability of important forms and paper stock. 
Ability to adapt plan to lesser disasters. 


Section 12. Disaster Site Rebuilding 


* Floor plan of data center. 


* Determine current hardware needs and possible alternatives. (See [Section 4.] 
Inventory Profile-Example” on page 498}) 


* Data center square footage, power requirements and security requirements. 


— Square footage 
— Power requirements 


— Security requirements: locked area, preferably with combination lock on one 


door. 


— Floor-to-ceiling studding 


— Detectors for high temperature, water, smoke, fire and motion 
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— Raised floor 


Vendors 


Floor Plan 
Include a copy of the proposed floor plan here. 


Section 13. Record of Plan Changes 


Keep your plan current. Keep records of changes to your configuration, your 
applications, and your backup schedules and procedures. For example, you can get 
print a list of your current local hardware, by typing: 


DSPLCLHDW OUTPUT (*PRINT) 
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Appendix C. Procedures for Recovering the Text Index 


‘Table 78} shows problems that can occur with the text-index database files and 
associated libraries. The table also provides solutions and procedures to correct the 


problems. 


Table 78. Recovery for Search Index Services Files 


Problem and Cause 


Solution 


Procedure 


Problem: 

All text index files are gone. 
Cause: 

Library QUSRSYS was cleared or 
deleted?. 


Restore all files from save media. 
After the restore operation is 
complete, run the reclaim 
operation”®. After the reclaim 
operation is complete, start updating 
index requests. 


= 


. RSTLIB SAVLIB(QUSRSYS) 
2. RCLDLO DLO(*DOCDTL) 
3. STRUPDIDX 


Problem: 

The scheduling queue file is not 
usable. 

Cause: 

Scheduling queue was damaged or 
deleted. 


Restore the scheduling queue file and 
optionally clear the scheduling 
queue. 


1. RSTOBJ OBJ(QABBIQTB) 
SAVLIB(QUSRSYS) 

2. WRKTXTIDX 

3. Select option 2 (Change details) 
on the index that has the 
scheduling queue to be cleared. 


4. Under the clear parameter, select 
a Y to clear the scheduling queue. 


Problem: 

The text index files are usable. Their 
content is not usable. 

Cause: 

Text index files that were not all 
saved at the same time were restored. 


Delete all the text index files from 
QUSRSYS and then restore all the 
files from save media‘. After the 
restore operation is complete, run the 
reclaim operation””. After the reclaim 
operation is complete, start updating 
index requests. 


4 


. DLTF OBJ(QABB*) LIB(QUSRSYS) 


2. RSTOBJ OBJ(QABB*) 
SAVLIB(QUSRSYS) 


3. RCLDLO DLO(*DOCDTL) 
4. STRUPDIDX 


Problem: 

The document library and text index 
files are lost. 

Cause: 

A disk unit failure occurred that 
resulted in data loss on the system 
ASP, or function code 24 was selected 
to install the Licensed Internal Code. 


Restore text index files and then the 


document library”. See cases 1 
through 4in fable 79 on page ST] 
about the types of index request 
created when using the RSTDLO 
command. 


See |Table 8 on page 67] for the 


procedure to restore the system ASP. 
The procedure restores QUSRSYS 
(text index files) and documents. 


Problem: 

The document library is lost. The text 
index files are not lost. 

Cause: 

Library QDOC or library QDOCnnnn 
was cleared or deleted. 
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Clear the scheduling queue®, restore 
the document library and start 
updating index requests. After the 
update operation has completed’, 
you may optionally want to run the 
reclaim operation, and then start 
updating index requests again*. See 
[Table 79 on page Sil] for rules about 
the types of index request created 
when using the RSTDLO command. 


1. WRKTXTIDX 


2. Select option 2 (Change details) 
on the index that has the 
scheduling queue to be cleared. 


3. Under the clear parameter, select 
a Y to clear the scheduling queue. 


4. RSTDLO DLO(*ALL) 
SAVELR(*ANY) 


5. STRUPDIDX 
6. RCLDLO DLO(*DOCDTL) 
7. STRUPDIDX 
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Table 78. Recovery for Search Index S: 


ervices Files (continued) 


Problem and Cause 


Solution 


Procedure 


Problem: 

One or more documents are lost. 
Cause: 

One or more documents were 
damaged or deleted. 


Start updating index requests®. After 
the update operation has completed®, 
restore the lost documents. Start 


updating index requests again. See 
cases 1 through 4 in |Table 79 on| 
page 511}about the types of index 


requests created when using the 
RSTDLO command. 


1. STRUPDIDX 


2. RSTDLO DLO(document-name 
SAVFLR(folder-name) 


3. STRUPDIDX 


Problem: 

One or more text index files are lost 
Cause: 

One or more QABB* files (except 
(QABBIQTB)) were damaged or 
deleted. Library QDOC is not lost. 


Create a save file for the undamaged 
scheduling queue. Save the 
scheduling queue to the save file. 
Delete all the text index files from 
QUSRSYS. Restore all the files from 
save media®. Delete the restored 
scheduling queue and then restore it 
from the save file’. After the restore 
operation is complete, run the 
reclaim operation””. When the 
reclaim operation is complete, start 
updating text index requests. When 
the update index requests are 
complete, delete the save file. 


1. CRISAVF 
FILE(QUSRSYS/SAVTXTQ) 
TEXT(‘Save of Text Search 
Scheduling Queue’) 

2. SAVOBJ OBJ(QABBIQTB) 
LIB(QUSRSYS) DEV(*SAVF) 
SAVF(QUSRSYS/SAVTXTQ) 
ACCPTH(*YES) 

3. DLTF FILE(QUSRSYS/QABB*) 


4. RSTOBJ OBJ(QABB*) 
SAVLIB(QUSRSYS) 


5. DLTF 
FILE(QUSRSYS/QABBIOTB) 


6. RSTOBJ OBJ(QABBIQTB) 
SAVLIB(QUSRSYS) DEV(*SAVF) 
SAVE(QUSRSYS/SAVTXTQ) 


RCLDLO DLO(*ALL) 
8. STRUPDIDX 
DLTF FILE(QUSRSYS/SAVTXTQ) 


~ 


© 


Problem: 

The last-version index dates for 
documents do not match, or 
documents you expected to find in a 
search are not found. 

Cause: 

STRUPDIDX command was 
interrupted, encountered errors, or 
was not started. 


Start updating index requests®, After 
the update operation has completed’, 
run the reclaim operation””. 


1. STRUPDIDX 
RCLDLO DLO(*ALL) 
3. STRUPDIDX 


nm 
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Table 78. Recovery for Search Index Services Files (continued) 


Problem and Cause Solution Procedure 


Notes: 


1 


Only library QUSRSYS is lost. The recovery for this problem is not used if you are recovering the system 
using function code 24 to install the Licensed Internal Code. 


The RCLDLO command deletes from the index all document content that does not have a corresponding 
document on the system. Documents that are stored in the index but not on the system take up space in 
the index, although they are never found in the search. 


The RCLDLO command looks at each index entry to see if the index date for both the entry and the 
corresponding document match. If the document date does not match, the date is stored in the index. If the 
document has a last-version index date with no corresponding entry in the index, the RCLDLO command 
creates an add request for the document to bring the index up to date. 


If the damaged files only are deleted and then restored without all other index files, the following occurs: 
* The restore operation clears the text index 


° The reclaim operation (RCLDLO command) creates an add index request for every document on the 
system that is marked as being indexed before. 


* The documents should correctly indicate whether they are or are not in the index. 


If the scheduling queue contains requests, these requests will be processed the next time the STRUPDIDX 
command is run. 


Pending requests on the scheduling queue could cause unpredictable results if the queue is not processed 
or cleared prior to performing the rest of the recovery operation. 


While the update operation is in progress, the Update Started status on the Work with Text Index display is 
set to Yes. When the update operation has completed, this status is set to No. A job completion message is 
also sent to the user who ran the STRUPDIDX command. 


Table 79. Type of Index Request Created when Using the Restore Document Library Object (RSTDLO) Command 


NEWOBJ(*NEW) Is_ | Document Was Index Entry Exists for Document | Type of Index Request Created 
Specified Indexed when Saved | in QABB* Files 

(1) No No No None 

(2) No No Yes Remove 

(3) No Yes No Add 

(4) No Yes Yes Create an add request if version 


indexed dates are different. 


None if version indexed dates 


are equal. 
(5) Yes No N/A None 
(6) Yes Yes N/A Add 
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Appendix D. Recovering your server 


This section provides instructions to completely recover your entire system. Use 
these steps if you need to recover your system to the same system (restore to the 
same system with the same serial number). Use these recovery instructions ONLY 
if you saved your entire system by using either of the following options: 

* Save menu Option 21 


* Equivalent Save Commands as Save menu Option 21: 


- SAVSYS 

- SAVLIB LIB(*NONSYS) ACCPTH(*YES) 

- SAVDLO DLO(FALL) SAVFLRFANY) 

- SAV DEV(’/QSYS.LIB/tape-device-name.DEVD’) OBJ((’/*’) 
(/QSYS.LIB’ *OMIT) (‘/QDLS’ *OMIT)) UPDHST(*YES) 


;_ Important 
Use |“Recovering your entire system after a complete system loss—Checklist 


20” on page 98| for any of the following cases. You can find the checklist in 


* System has Logical Partitions. 


* System uses the Alternate Installation Device Setup feature that you can 
define through DST for D-IPL.! 


* System has mounted User-Defined File Systems prior to save. 


If you are recovering to a different system (system with a different serial 


number), use |Appendix E, “Recovering your server to a different server” on 
ipage 529 


Check off each item as you complete the task. 
1. 


If you use Operations Console with LAN connectivity, you must 
resynchronize your PC device ID to be the same as the iSeries device ID. If 
you are resynchronizing V5R2 Operations Console, use the following 
instructions. If you are resynchronizing a previous release of Operations 
Console, see the Operations Console topic in the iSeries Information Center 
at http:/ /www.ibm.com/eserver/iseries /infocenter. 


a. In Operations Console select the connection name that you will be 
making the change for, then click Connection --> Properties. 


b. Select the Device ID page. 


c. Specify the appropriate passwords in the Password and Confirm 
password fields, then, click OK. 


d. Specify the correct Access password and click OK. 


1. Refer to|Chapter 18, “Using an Alternate Installation Device” on 
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If you are using Operations Console, LAN or direct connect, disconnect 
from your server and close Operations Console. Restart Operations Console 
and reconnect by using the user ID of 11111111 and password of 11111111 to 
sign on to your server. 


3. IPL the system from the first SAVSYS media. 


__a. Mount the first SAVSYS media on the alternate IPL device. Wait for 
the READY status. 


b. At the CPU control panel, place the system in MANUAL mode. 


c. Press the Function Select switch (or buttons) to display 02 (IPL) in 
the Function display. 


d. Press Enter. 


e. Press the Function Select switch (or buttons) to display D (IPL from 
tape or CD-ROM) in the Data display. 


f. Press Enter. 
__g. If the system is powered down, press the power button on the 
system to power the system on. Skip to Step|4} Otherwise, continue 
with Step 
h. If the system is powered on, press the Function Select switch (or 
buttons) to display 03 (continue the IPL) in the Function display. 
__i. Press Enter. 


4. On the Install Licensed Internal Code screen, select 1, Install Licensed 
Internal Code. 


(fo >) 


Install Licensed Internal Code 


Select one of the following: 
1. Install Licensed Internal Code 
2. Work with Dedicated Service Tools (DST) 
3. Define alternate installation device 


Selection 


il 


ES 


—_ 5. On the Install Licensed Internal Code (LIC) screen, select 2, Install Licensed 


Internal Code and Initialize System, to start a "Scratch Install” of the 
Licensed Internal Code. 


514 08/400 Backup and Recovery V5R2 


ie _ 


Install Licensed Internal Code (LIC) 

Disk selected to write the Licensed Internal Code to: 

Serial Number Type Model 1/0 Bus Controller Device 

XX=XXXXXXX XXXX XXX x Xx Xx 
Select one of the following: 
1. Restore Licensed Internal Code 
2. Install Licensed Internal Code and Initialize System 
3. Install Licensed Internal Code and Recover Configuration 
4. Install Licensed Internal Code and Restore Disk Unit Data 
5 


. Install Licensed Internal Code and Upgrade Load Source 


Selection 
2 
NS e/ 


6. On the Install LIC and Initialize System - Confirmation screen, press F10 to 
confirm the initialization and to continue the install. 


(— 4s 


Install LIC and Initialize System - Configuration 
Warning: 


All data on this system will be destroyed and the Licensed 
Internal Code will be written to the selected disk if you 
choose to continue the initialize and install. 


Return to the install selection screen and choose one of the 
other options if you want to perform some type of recovery 
after the install of the Licensed Internal Code is complete. 


Press F10 to continue the install. 
Press F12 (Cancel) to return to the previous screen. 
Press F3 (Exit) to return to the install selection screen. 


__a. The Initialize the Disk - Status screen appears. 


Initialize the Disk - Status 
The load source disk is being initialized. 


Estimated time to initialize in minutes: xx 
Elapsed time in minutes ........ 2 020 


__b. The Install Licensed Internal Code - Status screen appears. 


Install Licensed Internal Code - Status 


Install the Licensed Internal Code in progress 


Percent Complete ..... 0% 8.5 minutes 
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7. On the Disk Configuration Attention Report screen, press F10 to accept any 
problems and to continue. 


a >) 
Disk Configuration Attention Report 


Type option, press Enter 
5=Display Detailed Report 


Press F1Q to accept all the following problems and continue. 
The system will attempt to correct them. 


OPT Problem 
_ New disk configuration 


F3=Exit Fl0=Accept the problems and continue ) 
8. On the IPL or Install the System screen, select 3, Use Dedicated Service 
Tools (DST). 
Va 
IPL or Install the System > 
Select one of the following: 
1. Perform an IPL 
2. Install the operating system 
3. Use Dedicated Service Tools (DST) 
4. Perform automatic installation of the operating system 
5. Save Licensed Internal Code 
Selection 
3 
Ke S/ 


9. Sign on to DST as DST user, QSECOFR, with the password QSECOFR. 


Dedicated Service Tools (DST) Sign On 
Type choices, press Enter. 


DSMesUS@r Stiaeaves ce saesause QSECOFR 
DSi password: ca es QSECOFR 


a. The service tools profile QSECOFR password is expired after the 
first use. At the Change Service Tools User Password screen, enter in 
all uppercase letters the current password QSECOFR and a new 
password, along with the verification password. 
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ie _ 


Change Service Tools User Password 


Service tools user profile name . . . . : QSECOFR 
Password last changed. ...... . . : mm/dd/yy 


Type choices, press Enter. 


Current password. <3 0: « « @ %....5:« 3 QSECOFR 
NeWnpassword'’ 2020 63 Wk As eke 
New password (to verify). ......: 


Se eee—e—E———EEEEESESESEEEE EE 


b. Select option 4, Work with Disk Units. 

c. Select option 1, Work with Disk Configuration. 
d. Select option 3, Work with ASP Configuration. 
e. Select option 3, Add Units to ASPs. 


__ 10. On the Specify ASPs to Add Units to screen, enter "1" for each unit that 
needs to be in the System ASP (ASP 1). 


__a. If you require more than one ASP, enter the corresponding ASP 
number on each selected unit. 


iS > 
Specify ASPs to Add Units to 
Specify the ASP to add each unit to. 
Specify Serial Resource 
ASP Number Type Model Capacity Name 
1 00-0103706 6602 030 1031 DDO31 
1 00-1000341 9337 211 542 DDO12 
1 00-5000341 9337 211 542 DDO15 
1 00-7000341 9337 211 542 DDO11 
1 00-3000341 9337 211 542 DDO14 
1 00-2000341 9337 211 542 DDO13 
1 = 00-61300 6603 074 1475 DD006 
1 00-52262 6606 074 1475 DDO08 
1 00-86978 6606 050 1967 DDO09 
2  00-95744 6603 074 1475 DDOO5 
2  00-47657 6606 074 1475 DD007 
-  00-0238703 6602 074 773 =DDO51 
- 00-0128350 6602 074 773 =DDO51 


eee eee a —————————— ree | 


__b. After you complete all units, press Enter. 
__c. If the list of units is correct, press Enter to start initializing the units. 
__ 11. On the Problem Report screen, press F10, Ignore problems and continue. 
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Problem Report 


Note: Some action for the problems listed below may need to 
be taken. Please select a problem to display more detailed 
information about the problem and to see what possible 
action may be taken to correct the problem. 


Type option, press Enter. 
5=Display Detailed Report 


OPT Problem 
_ Unit possibly configured for Power PC AS 


F3=Exit F10=Ignore problems and continue F12=Cancel 


oe 


__ 12. On the Confirm Add Units screen, press Enter to confirm the selected units. 


( Confirm Add Units >) 


Add will take several minutes for each unit. The system will 
have the displayed protection after the unit(s) are added. 


Press Enter to confirm your choice for 1=Add units. 
Press F9=Capacity Information to display the resulting capacity. 
Press Fl2=Cancel to return and change your choice. 


Serial Resource 
ASP Unit Number Type Model Name Protection 


1 Unprotected 
00-0103706 6602 030 D031 Unprotected 
00-1000341 9337 211 DO12 Unprotected 
00-5000341 9337 211 DO15 Unprotected 
00-7000341 9337 211 DO11 Unprotected 
00-3000341 9337 211 DO14 Device Parity 
00-2000341 9337 211 D013 Device Parity 
00-61300 6603 074 DO06 Device Parity 
00-52262 6606 074 D008 Device Parity 
00-86978 6606 050 D009 Device Parity 
2 Unprotected 
1000-95744 6603 074 DOO5 Device Parity 
1100-47657 6606 074 DOO7 Device Parity 


OANA OTH WNPEHE 
oe = A = el i | 


i=) 


i=) 


__a. The Function Status screen displays the percentage of completion. 

b. The "Selected units have been added successfully" message appears 
when the system completes the Add Units process. 

c. Press F12 to return to the Work with Disk Configuration screen. 

d. If your system requires mirrored protection, continue to Step|[12¢| If 
your system does not require mirrored protection, press F3 until you 
see the Exit Dedicated Service Tools (DST) screen. Select 1 to exit DST 
and press Enter and continue to Step |12f on page 519 


e. To start mirrored protection for your system, follow these 
instructions: 
__ 1) On the Work with Disk Configuration screen, select 4, Work 
with Mirrored Protection. 


___2) On the Work with Mirrored Protection screen, select 2, Start 
Mirrored Protection. 


518 0S/400 Backup and Recovery V5R2 


3) Select an ASP by placing a "1" next to it. Press Enter to start 
mirrored protection. 

__ 4) On the Confirm Continuation screen, press Enter. 

__ 5) On the Confirm Start Mirrored Protection screen, press Enter. 

6) The Function Status screen displays the completion status of 
the Start Mirrored Protection request. 

__7) The Start mirroring completed successfully message appears on 
the Disk Configuration Information Report screen. 

8) Press Enter to continue. 


__f. If you use Operations console, follow these instructions to switch 
working from ‘local console’ to ‘operations console’: 
__ 1) On the IPL or Install the System screen, select 3, Use Dedicated 
Service Tools (DST). Press Enter to continue. 
2) Sign on to DST as DST User, QSECOFR, with the password 
QSECOFR. 
3) On the Use Dedicated Service Tools (DST) screen, select 5, Work 
with DST environment. Press Enter to continue. 
4) On the Work with DST Environment screen, select 2, System 
Devices. Press Enter to continue. 
5) On the Work with System Devices screen, select 6, Console 
Mode. Press Enter to continue. 
6) On the Select Console Type screen, select 2, Operations Console. 
Press Enter to continue. 


7) Press F3 or F12 to get back to the IPL or Install the System 


screen. 
__ 13. On the IPL or Install the System screen, select 2, Install the Operating 
System. 
A 
IPL or Install the System “ 
Select one of the following: 
1. Perform an IPL 
2. Install the Operating System 
3. Use Dedicated Service Tools (DST) 
4. Perform automatic installation of the Operating System 
5. Save Licensed Internal Code 
Selection 
2 
Ne af 


a. On the Confirm Install of OS/400 screen, press Enter. 


b. The Select a Language Group screen displays the primary language 
feature that is currently on your save media. Press Enter to accept 
this value. 
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- > 


Select a Language Group 


Note: The language feature shown is the language feature 
installed on the system. 


Attention: To keep the same primary language, ensure that the 
media you use for installing the operating system 
matches the language feature shown. If the operating 
system media does not match what is shown, the 
installation process will attempt to install the 
operating system in a different language feature than 
Licensed Internal Code. This is undesirable. 
Type Choice, press Enter. 


Language Feature. ........ 2924 
Ss A 


__c. The Confirm Language Feature Selection screen appears. Press Enter to 
continue. 


__ 14. On the Add All Disk Units to the System screen, select option 1, Keep the 
current disk configuration. 


Add All Disk Units to the System 
Select one of the following: 


. Keep the current disk configuration 

. Perform disk configuration using DST 

. Add all units to the system auxiliary storage pool (ASP) 
. Add all units to the system ASP and balance data 


PwWNMrH 


Selection 
1 
‘NS SS 


Note: This screen does not appear if you selected all disk units that are 
known to the system on Step|10 on page 517 


__ 15. The IPL Step in Progress screen displays the IPL progress. 


(Ss >) 


IPL Step in Progress 
IPL step . . . : Storage Management Recovery 


Authority Recovery 
Journal Recovery 
Database Recovery 
Journal Synchronization 


Start Operating System 
ey 


__ 16. On the Install the Operating System screen, select option 1, Take defaults. 
Make sure that the values for Date and Time are correct. Press Enter to 
continue. 
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ie = 


Install the Operating System 
Type options, press Enter. 
Install 
OPTION, ws oS 1 1=Take defaults (No other 
options are displayed) 
2=Change install options 
Date 
NGare aes eure tous 99 00-99 
Mon this, ictecsec aioe 08 01-12 
Day crc fe a 22 01-31 
Time 
HOUM ve. ce ee 16 00-23 
MinUte@ot 2 ss, 45 00-59 
Second! vs. 6: sos s 00 00-59 


4 


__17. The OS/400 Installation Status screen displays the installation status of the 
required OS/400 Installation Profiles and Libraries. 


_ 


fe 
Message ID . . : CP12070 0S/400 Installation Status 


Installation Objects 
Stage Completed Restored 


Creating needed profiles and libraries . . .: 
Restoring programs to library QSYS.....: 
Restoring language objects to library QSYS .: 
Updating: program table .. . «6 4 6. ea a 8 ; 
Installing database files .........: 
Completing OS/400 installation. ......: 


(Ce oe 


__ 18. The system installs the remaining OS/400 objects. 


fe 
Message ID . . : CPI2070 0S/400 Installation Status 


Installation Objects 
Stage Completed Restored 


Creating needed profiles and libraries . . .: 
Restoring programs to library QSYS.... .: 
Restoring language objects to library QSYS .: 
Updating: program ‘table. 3. 24s woe ee 
Installing database files .........: 
Completing 0S/400 installation. ......: 


09 
03 


«x KKK OK 


(BOAO oe 


y 


__ 19. On the Sign On screen, logon as user QSECOFR. You do not need to enter a 
password at this time. 


__ 20. On the IPL options screen, enter correct values for Date and Time. Only the 
following options should be set to Y: 


* Start system to restricted state 
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* Set major system options 
* Define or change the system at IPL 


(eae Fa AE Ta aa 


IPL Options 


Type choices, press Enter. 


Systemsdates A. 2: cgots cates oe fees oe eases 08/22/99 MM/DD/Y 

SySitemetimes s25..1 ey vat siestees ler eeu ease. neg ee 16:58:00 HH:MM:S 

Clear gob: queues: = 6 «<3 ee we Se N Y=Yes, N=No 
Clear-output queues’ 2.24 3 3 3 oe as N Y=Yes, N=No 
Clear incomplete job logs ........ N Y=Yes, N=No 
Start. print writers: <4 ups & % a N Y=Yes, N=No 
Start system to restricted state ..... Y Y=Yes, N=No 
Set major system options ......... NE Y=Yes, N=No 
Define or change system at IPL...... Y Y=Yes, N=No 

S 2 


__a. On the Set Major System Options screen, select N to disable automatic 
configuration. 


Set Major System Options 


Type choices, press Enter. 


Enable automatic configuration... .N Y=Yes, N=No 
Device configuration naming NORMAL *NORMAL, *S36 
*DEVADR 

Default special environment *NONE *NONE, *S36 


__ 21. The Define or Change the System at IPL screen appears. 
__a. Select 3, System Value Commands. 


b. On the Change System Value Commands screen, select 3, Work with 
System Values. 


c. On the Work with System Values screen, select the System Value that 
you plan to change by placing a "2" next to it. Press Enter ONLY 
after you select all the values. 


Update the following System Values. Write down the existing values 
so you can update them after the recovery, if necessary. 


* Change QALWOBJRST to *ALL 
* Change QJOBMSGQEL to *PRTWRAP 
* Change QJOBMSGQMxX size to a minimum value of 30 
* Change QPFRADJ to 2 
* Change QIPLTYPE type to 2 
* Change QVFYOBJRST to 1 
d. After the system changes the system values, press F3 twice to return 
to the Define or Change the System at IPL screen. 
e. On the Define or Change the System at IPL screen, press F3 to exit and 
continue the IPL. 
___ 22. On the Change Password screen, type QSECOFR as the current password. 
Enter a new password. Re-enter the password to verify and press Enter. 
(New password cannot be QSECOFR.) 
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Va 


Password last changed ...... xX/XX/XX 


Type choices, press Enter. 


Change Password 


Current password... ...... QSECOFR 
New password . 5. 406 29) 43 a « 
New password (to verify) ..... 


ss. / 


___ 23. To configure 3422, 3430, 3480, or 3490 tape units, follow these instructions. 


If you have_a 3490 Model E or F or to configure other types of tape units, 


go to sep 
a. Use the Work with Hardware Resource (WRKHDWRSC) command to 
determine the location of the tape controller. 
WRKHDWRSC TYPE(*STG) 


b. Create the controller description for the tape controller by doing the 
following: 


1) Locate the resource name for the tape controller on the Work with 
Storage Resources display. The value 34xx is displayed in the Type 
column. 


2) Write down the name of the resource. 


3) Type a 9 (Work with resource) in the Opt column next to name of 
the tape controller and press the Enter key. You see the Work with 
Storage Resources display. 


Note: If the resource is not listed on the display, you need to select 
other resources, such as disk storage controllers. For some 
server models, resources are now attached through 
combined-function IOPs. Look through the resources until 
you find the device you want. 

4) Type 5 (Work with controller descriptions) in the Opt column in 
front of the tape controller. You see the Work with Controller 
Description display. 

5) Type 1 (Create) in the Opt column on the top line. 

6) Type the controller name (such as TAPCTLO1) in the description 
field and press the Enter key. You see the Create Controller 
Description display. 

7) If necessary, type additional information on the display. Then press 
the Enter key. You return to the Work with Controller Descriptions 
display. 

8) If the controller description that you created does not appear, press 
F5 (Refresh). 

c. To create device descriptions for the tape units that are attached to the 
controller, do the following: 

1) On the work with Controller Descriptions display, press F23 (More 
options). The list of options changes. 

2) Type 9 (Work with associated descriptions) in the Opt column in 
front of the new tape controller. You see the Work with Associated 
Descriptions display. 

3) Locate the resource for the tape unit. Because no device description 
exists, the description says *NONE. 
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= 


Write down the name of the tape resource. 


a 


Type a 1 (Create) in the Opt column next to the description of 
*NONE and press the Enter key. You see the Create Device Desc 
(Tape) (CRTDEVTAP). 


6) In the Device description field, type a name such as TAPO1. 


7) In the Resource name prompt, type the name that you wrote down 
in step (If you did not write it down, press F12 to return to 
the display. Repeat steps through 23c7]) 

8) Press the Enter key. 

9) Additional parameters appear on the display. 

10) If necessary, type additional information on the display. Then press 
the Enter key. You return to the Work with Associated Descriptions 
display. 

11) Press F5 (Refresh). The name of the description that you created 
should now be associated with the resource. 

12) Type 8 (Work with configuration status) in front of the controller 
description and the device description. You see the Work with 
Configuration Status display. 

13) Type 1 (Vary on or Make available) in front of the controller and 
the devices. 


d. Press F3 until your return to your original menu. 
___ 24. To configure tape units that are 3490 Model E or F, or that are not models 

34xx, use the following instructions: 

a. Use the Work with Hardware Resource (WRKHDWRSC) command to 
determine tape controller name. 
WRKHDWRSC TYPE (*STG) 

b. Locate the tape controller on the Work with Hardware Resources 
display. 

c. Type a 9 (Work with resource) next to tape controller name and press 
the Enter key. 


Note: If the tape controller is not listed on the display, you need to 
select other resources, such as disk storage controllers. For some 
server models, tape units are now attached through 
combined-function IOPs. Look through the resources until you 
find the tape unit you want. 


d. Locate the resource name for the tape unit (for example, TAPO1). 


e. Enter a 5 (Work with Configuration Descriptions) in the Opt column 
next to the tape resource name and press the Enter key. 

You are shown the Work with Configuration Descriptions display. 

f. Type a1 (Create) in the Opt field and a tape device description name 
(for example, TAPO1) in the Description field. Press the Enter key. You 
are shown the Create Device Description (Tape) display. 

g. Change any values that you want to change, then press the Enter key 
(twice) to create the device description. You are shown the Work with 
Configuration Descriptions display again. The device that you created 
should appear on the display. 

h. Type an 8 (Work with configuration status) in front of the new device 
description. You are shown the Work with Configuration Status display. 

i. Type a 1 (Vary on or Make available) in front of the new device. If the 
status does not change to Varied On or Available, wait a few minutes. 
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Then press F5 (Refresh). If the status still does not change to Varied On 
or Available, follow normal problem analysis for the device. 


j. Press F3 until you return to the main menu. 


ia 


OrFWoOoOnanFwnre 


wor 


=> 


SS 


Select one of the following: 


. User tasks 

. Office tasks 

. General system tasks 

. Files, libraries, and folders 
. Programming 

. Communications 

. Define or change the system 
. Problem handling 

. Display a menu 

. Client Access/400 tasks 

. Sign off 


Selection or command 


0S/400 Main Menu 


yf 


__ 25. 


26. 


27. 


On the OS/400 Main Menu screen, type the command, WRKRPYLE, and check 
to see if CPA3709 is there. If it is not, determine an available sequence 
number and then Press F6 to add MSGID(CPA3709) RPY(G) by using the 
available sequence number. Press F5 to Refresh and verify that you added 
CPA3709. 


__a. Type the command CHGJOB INQMSGRPY(*SYSRPYL) to update the 
current job to use the system reply list for inquiry messages. 


On the OS/400 Main Menu screen, type GO RESTORE to access the OS/400 
Restore screen. 


__a. On the Restore screen, select option 21, Restore System and User 
Data. 


__b. Press Enter to continue. 


On the Specify Command Defaults screen, enter the name of the tape drive 
that you are using for the restore. 


__a. Set Prompt for command to N. 
__b. Set Message queue delivery to *NOTIFY. 


Specify Command Defaults 


Type choices, press Enter. 


Tape devices: «2%. 6 os ey ee ee TAPO1 Names 

Prompt for commands. ........ N Y=Yes, N=No 
Message queue delivery ....... *NOTIFY *BREAK, *NOTIFY 
Restore to different system. .... N Y=Yes, N=No 


__c. Press Enter to continue ending the subsystems. The restore process 
starts to run unattended. The restore process stops only if the system 
requires a tape mount for the restore process to continue. The restore 
process should run to completion. 


___ 28. Reapply any PTFs that you applied since since the last time that you saved 


your system data. 
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29. 


30. 


__ 31. 


32. 


__ 33. 


__ 34. 


35. 


a. Locate the most recent cumulative PTF (program temporary fix) 
tape. 

b. From a command-line, enter GO PTF to access the PTF menu. 

c. Select 8, Install program temporary fix package, on the PTF menu. 
This installs all of the PTFs in the cumulative PTF package for the 
licensed programs that are installed on your system. Refer to the 
OS/400 PTF Shipping Information Letter for required special 
instructions. 

Notes: 


1) If you want to restore individual PTFs, see the Systems Operation 
publication for more information about applying individual 
PTFs. 


2) If you do not have the PTFs that you need, order them and 
apply them later. 


If necessary, change the following system values back to their original 
value by using the WRKSYSVAL command. 


* QALWOBJRST 

* OIPLTYPE 

* QJOBMSGQFL 

* QJOBMSGQMX 

* QPFRADJ 

* QVFYOBJRST 

If you do not know the password for the restored QSECOFR profile, 
change the password before signing off. Type the following command: 
CHGUSRPRF USRPRF(QSECOFR) PASSWORD (new-password) 

To place scheduled jobs on hold, type WRKJOBSCDE and select option 3 to 
hold any scheduled jobs. You need to release the jobs in Step [38 onl 

after you complete the restore. 

Type the command, SIGNOFF *LIST or DSPJUOBLOG * *PRINT. Check the job 
log to ensure that the job restored all objects. To verify if the job restored 
all objects, spool the job log for printing along with any remaining spooled 


job output. Check for any error messages. Correct the errors and restore 
those objects from media. 


Perform an IPL of the system. 
a. On the CPU control panel, select the NORMAL setting. 
b. Type the following command: 


PWRDWNSYS OPTION(*IMMED) RESTART (*YES 
*FULL) IPLSRC(B) 


If you installed Content Manager OnDemand for iSeries (5769-RD1) on 
your system, restart the journaling for Content Manager OnDemand for 
iSeries (5769-RD1) by typing the following commands: 


CALL QRDARS/QRLCSTRJ PARM('RLC') 
CALL QRDARS/QRLCSTRJ PARM('RLR') 
CALL QRDARS/QRLCSTRJ PARM('RLO') 


If you installed iSeries Integration for Windows Server (5722-WSV) on 
your system and you saved with your network servers in a VARIED ON 
setting, perform the following steps: 
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36. 


__ 37. 


__ 38. 


a. Vary off any network servers that are varied on by using the 
WRKCFGSTS *NWS command. Select option 2. 


b. Create any needed Network Storages by using the CRTNWSSTG 
command. 


c. Add the storage links by using the ADDNWSSTGL command. 


d. Vary on your network servers by using the WRKCFGSTS «NWS 
command. Select option 1. 


e. Restore iSeries Integration for Windows Server (5722-WSV) data by 
typing RST OBJ('/QNTC'). 
__f. Press Enter. 


__g. Follow the instructions in Step |32 on page 526] to check for error 


messages, verify your restore, and correct any errors. 


If you installed iSeries Integration for Windows Server (5722-WSV) on 
your system and you saved with your network server in a VARIED OFF 
setting, perform the following steps: 


a. Add the links for the server descriptions. Type the following for 
each server description: 


ADDNWSSTGL NWSSTG(Storage Name) NWSD(Server_ Description) 


b. Vary on your network servers by typing WRKCFGSTS *NWS and by 
selecting option 1 to vary on each network server. 


If you installed Cryptographic Access Provider 128-bit for iSeries 
(5769-AC3) on your system, reinstall it by using option 11 on the Work with 
Licensed Programs menu. 


Release the jobs that you previously held in Step|31 on page 526 
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Appendix E. Recovering your server to a different server 


This section provides instructions to completely recover your entire AS/400 or 
iSeries server. Use these steps if you need to recover your server to a different 
server (for example, a server with a different serial number). 


Note: If you are performing a system migration you must also refer to the 
Installation, Upgrades, and Migration —> Migration topic in the iSeries 
Information Center (http:/ /www.ibm.com/eserver/iseries /infocenter). 

Use these recovery instructions only if you saved your entire system by using 

either of the following options: 


* Save menu Option 21 


* Equivalent Save Commands as Save menu Option 21: 


- SAVSYS 

- SAVLIB LIB(*NONSYS) ACCPTH(*YES) 

- SAVDLO DLO(*ALL) SAVFLR(*ANY) 

- SAV DEV(’/QSYS.LIB/tape-device-name.DEVD’) OBJ((’/*’) 
(’/QSYS.LIB’ *OMIT) (‘/QDLS’ *OMIT)) UPDHST(*YES) 


(— Important 


“Recovering your entire system after a complete system loss—Checklist 


* System has Logical Partitions. 


* System has mounted User-Defined File Systems prior to save. 


If a tape device is used for alternate IPL that is connected to a bus other than 
the system bus (bus 1), or if it is a fibre channel tape device, refer to the steps 
found in Defining an Alternate Installation device chapter. If you define an 
alternate installation device, load both the Licensed Internal Code CD-ROM 
and your SAVSYS tape media to perform the recovery. 


Check off each item as you complete the task. 


1. If you use Operations Console with LAN connectivity, you must disconnect 
Operations Console from the server, resynchronize your PC device ID, then 
connect to Operations Console, to be the same as the iSeries device ID. If 
you are resynchronizing V5R2 Operations Console, use the following 
instructions. If you are resynchronizing a previous release of Operations 
Console, see the Operations Console topic in the iSeries Information Center 
at http:/ /www.ibm.com/eserver/iseries /infocenter. 


a. If Operations Console is connected to the server, select the connection 
name in Operations Console that you will be making the change for, 
then click Connection --> Disconnect. 


b. In Operations Console select the connection name that you will be 
making the change for, then click Connection --> Properties. 


c. Select the Device ID page. 


d. Specify the appropriate passwords in the Password and Confirm 
password fields, then click OK. 
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e. Specify the correct Access password and click OK. 


f. Select the connection name that you the changed, then click Connection 
--> Connect. 


If you are using Operations Console, LAN or direct connect, disconnect 
from your server and close Operations Console. Restart Operations Console 
and reconnect by using the user ID of 11111111 and password of 11111111 to 
sign on to your server. 


a. 


3. IPL the system from the first SAVSYS media. 


Mount the first SAVSYS media on the alternate IPL device. Wait for 
the READY status. 


At the CPU control panel, place the system in MANUAL mode. 


c. Press the Function Select switch (or buttons) to display 02 (IPL) in 


the Function display. 


d. Press Enter. 


e. Press the Function Select switch (or buttons) to display D (IPL from 


tape or CD-ROM) in the Data display. 


Press Enter. 


. If the system is powered down, press the power button on the 


system to power the system on. Skip to Step|4| Otherwise, continue 
with Step 


. If the system is powered on, press the Function Select switch (or 


buttons) to display 03 (continue the IPL) in the Function display. 


Press Enter. 
4. On the Install Licensed Internal Code screen, select 1, Install Licensed 


Internal Code. 


a 


Ls ns tailil 


Selection 
1 


Select one of the following: 


2. Work with Dedicated Service Tools (DST) 
3. Define alternate installation device 


Install Licensed Internal Code 


Licensed Internal Code 


SS sss ss sss sss sss sss 


—_ 5. On the Install Licensed Internal Code (LIC) screen, select 2, Install Licensed 
Internal Code and Initialize System, to start a "Scratch Install” of the 
Licensed Internal Code. 
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ie _ 


Install Licensed Internal Code (LIC) 

Disk selected to write the Licensed Internal Code to: 

Serial Number Type Model 1/0 Bus Controller Device 

XX=XXXXXXX XXXX XXX x Xx Xx 
Select one of the following: 
1. Restore Licensed Internal Code 
2. Install Licensed Internal Code and Initialize System 
3. Install Licensed Internal Code and Recover Configuration 
4. Install Licensed Internal Code and Restore Disk Unit Data 
5 


. Install Licensed Internal Code and Upgrade Load Source 


Selection 
2 
NS e/ 


6. On the Install LIC and Initialize System - Confirmation screen, press F10 to 
confirm the initialization and to continue the install. 


(— 4s 


Install LIC and Initialize System - Configuration 
Warning: 


All data on this system will be destroyed and the Licensed 
Internal Code will be written to the selected disk if you 
choose to continue the initialize and install. 


Return to the install selection screen and choose one of the 
other options if you want to perform some type of recovery 
after the install of the Licensed Internal Code is complete. 


Press F10 to continue the install. 
Press F12 (Cancel) to return to the previous screen. 
Press F3 (Exit) to return to the install selection screen. 


__a. The Initialize the Disk - Status screen appears. 


Initialize the Disk - Status 
The load source disk is being initialized. 


Estimated time to initialize in minutes: xx 
Elapsed time in minutes ........ 2 020 


__b. The Install Licensed Internal Code - Status screen appears. 


Install Licensed Internal Code - Status 


Install the Licensed Internal Code in progress 


Percent Complete ..... 0% 8.5 minutes 
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7. On the Disk Configuration Attention Report screen, press F10 to accept any 
problems and to continue. 


a >) 
Disk Configuration Attention Report 


Type option, press Enter 
5=Display Detailed Report 


Press F1Q to accept all the following problems and continue. 
The system will attempt to correct them. 


OPT Problem 
_ New disk configuration 


F3=Exit Fl0=Accept the problems and continue ) 
8. On the IPL or Install the System screen, select 3, Use Dedicated Service 
Tools (DST). 
Va 
IPL or Install the System > 
Select one of the following: 
1. Perform an IPL 
2. Install the operating system 
3. Use Dedicated Service Tools (DST) 
4. Perform automatic installation of the operating system 
5. Save Licensed Internal Code 
Selection 
3 
Ke S/ 


9. Sign on to DST as DST user, QSECOFR, with the password QSECOFR. 


Dedicated Service Tools (DST) Sign On 
Type choices, press Enter. 


DSMesUS@r Stiaeaves ce saesause QSECOFR 
DSi password: ca es QSECOFR 


a. The service tools profile QSECOFR password is expired after the 
first use. At the Change Service Tools User Password screen, enter in 
all uppercase letters the current password QSECOFR and a new 
password, along with the verification password. 
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ie _ 


Change Service Tools User Password 


Service tools user profile name . . . . : QSECOFR 
Password last changed. ...... . . : mm/dd/yy 


Type choices, press Enter. 


Current password. <3 0: « « @ %....5:« 3 QSECOFR 
NeWnpassword'’ 2020 63 Wk As eke 
New password (to verify). ......: 


SN e—e——e—eE—————EeEEEEEEEEESESEEEEE EE 


b. Select option 4, Work with Disk Units. 

c. Select option 1, Work with Disk Configuration. 
d. Select option 3, Work with ASP Configuration. 
e. Select option 3, Add Units to ASPs. 


__ 10. On the Specify ASPs to Add Units to screen, enter 1 for each unit that needs 
to be in the System ASP (ASP 1). 


__a. If you require more than one ASP, enter the corresponding ASP 
number on each selected unit. 


iS > 
Specify ASPs to Add Units to 
Specify the ASP to add each unit to. 
Specify Serial Resource 
ASP Number Type Model Capacity Name 
1 00-0103706 6602 030 1031 DDO31 
1 00-1000341 9337 211 542 DDO12 
1 00-5000341 9337 211 542 DDO15 
1 00-7000341 9337 211 542 DDO11 
1 00-3000341 9337 211 542 DDO14 
1 00-2000341 9337 211 542 DDO13 
1 = 00-61300 6603 074 1475 DD006 
1 00-52262 6606 074 1475 DDO08 
1 00-86978 6606 050 1967 DDO09 
2  00-95744 6603 074 1475 DDOO5 
2  00-47657 6606 074 1475 DD007 
-  00-0238703 6602 074 773 =DDO51 
- 00-0128350 6602 074 773 =DDO51 


eee eee a ee ————————— ree | 


__b. After you complete all units, press Enter. 
__c. If the list of units is correct, press Enter to start initializing the units. 
__ 11. On the Problem Report screen, press F10, Ignore problems and continue. 
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Problem Report 


Note: Some action for the problems listed below may need to 
be taken. Please select a problem to display more detailed 
information about the problem and to see what possible 
action may be taken to correct the problem. 


Type option, press Enter. 
5=Display Detailed Report 


OPT Problem 
_ Unit possibly configured for Power PC AS 


F3=Exit F10=Ignore problems and continue F12=Cancel 


oe 


__ 12. On the Confirm Add Units screen, press Enter to confirm the selected units. 


( Confirm Add Units >) 


Add will take several minutes for each unit. The system will 
have the displayed protection after the unit(s) are added. 


Press Enter to confirm your choice for 1=Add units. 
Press F9=Capacity Information to display the resulting capacity. 
Press Fl2=Cancel to return and change your choice. 


Serial Resource 
ASP Unit Number Type Model Name Protection 


1 Unprotected 
00-0103706 6602 030 D031 Unprotected 
00-1000341 9337 211 DO12 Unprotected 
00-5000341 9337 211 DO15 Unprotected 
00-7000341 9337 211 DO11 Unprotected 
00-3000341 9337 211 DO14 Device Parity 
00-2000341 9337 211 D013 Device Parity 
00-61300 6603 074 DO06 Device Parity 
00-52262 6606 074 D008 Device Parity 
00-86978 6606 050 D009 Device Parity 
2 Unprotected 
1000-95744 6603 074 DOO5 Device Parity 
1100-47657 6606 074 DOO7 Device Parity 


OANA OTH WNPEHE 
oe = A = el i | 


i=) 


i=) 


__a. The Function Status screen displays the percentage of completion. 

b. The "Selected units have been added successfully" message appears 
when the system completes the Add Units process. 

c. Press F12 to return to the Work with Disk Configuration screen. 

d. If your system requires mirrored protection, continue to Step|[12¢| If 
your system does not require mirrored protection, press F3 until you 
see the Exit Dedicated Service Tools (DST) screen. Select 1 to exit DST 
and press Enter and continue to Step |12f on page 535 


e. To start mirrored protection for your system, follow these 
instructions: 
__ 1) On the Work with Disk Configuration screen, select 4, Work 
with Mirrored Protection. 


___2) On the Work with Mirrored Protection screen, select 2, Start 
Mirrored Protection. 
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3) Select an ASP by placing a "1" next to it. Press Enter to start 
mirrored protection. 

__ 4) On the Confirm Continuation screen, press Enter. 

__ 5) On the Confirm Start Mirrored Protection screen, press Enter. 

6) The Function Status screen displays the completion status of 
the Start Mirrored Protection request. 

__7) The Start mirroring completed successfully message appears on 
the Disk Configuration Information Report screen. 

8) Press Enter to continue. 


__f. If you use Operations console, follow these instructions to switch 
working from ‘local console’ to ‘operations console’: 
__ 1) On the IPL or Install the System screen, select 3, Use Dedicated 
Service Tools (DST). Press Enter to continue. 
2) Sign on to DST as DST User, QSECOFR, with the password 
QSECOFR. 
3) On the Use Dedicated Service Tools (DST) screen, select 5, Work 
with DST environment. Press Enter to continue. 
4) On the Work with DST Environment screen, select 2, System 
Devices. Press Enter to continue. 
5) On the Work with System Devices screen, select 6, Console 
Mode. Press Enter to continue. 
6) On the Select Console Type screen, select 2, Operations Console. 
Press Enter to continue. 


7) Press F3 or F12 to get back to the IPL or Install the System 


screen. 
__ 13. On the IPL or Install the System screen, select 2, Install the Operating 
System. 
A 
IPL or Install the System “ 
Select one of the following: 
1. Perform an IPL 
2. Install the Operating System 
3. Use Dedicated Service Tools (DST) 
4. Perform automatic installation of the Operating System 
5. Save Licensed Internal Code 
Selection 
2 
Ne YY 


__a. Make a selection on the Install Device Type Selection screen and press 
Enter. 


Install Device Type Selection 
System: XXXX 
Select the installation device type: 


1. Tape 
2. Optical 
3. Virtual optical - preselected image catalog 


__b. On the Confirm Install of OS/400 screen, press Enter. 
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__c. The Select a Language Group screen displays the primary language 
feature that is currently on your save media. Press Enter to accept 
this value. 


je > 


Select a Language Group 


Note: The language feature shown is the language feature 
installed on the system. 


Attention: To keep the same primary language, ensure that the 
media you use for installing the operating system 
matches the language feature shown. If the operating 
system media does not match what is shown, the 
installation process will attempt to install the 
operating system in a different language feature than 
Licensed Internal Code. This is undesirable. 
Type Choice, press Enter. 
Language Feature... ...560. 2924 


S y 


__d. The Confirm Language Feature Selection screen appears. Press Enter to 
continue. 


__ 14. On the Add All Disk Units to the System screen, select option 1, Keep the 
current disk configuration. 


a ; = 
Add All Disk Units to the System 


Select one of the following: 


. Keep the current disk configuration 

. Perform disk configuration using DST 

. Add all units to the system auxiliary storage pool (ASP) 
. Add all units to the system ASP and balance data 


PWNHrE 


Selection 
1 


Note: This screen does not appear if_you selected_all disk units that are 
known to the system on Step|10 on page 533 


__ 15. The Licensed Internal Code IPL in Progress screen displays the IPL progress. 


fe 2 


Licensed Internal Code IPL in Progress 


TRE: 
IY DO sare mrnvereememe sonst Attended 
Start date and time . xx/xx/xx xXxX:Xx:XX 
Previous system end . Normal 


We Step ..... . : Storage Management Recovery 


a 


__ 16. On the Install the Operating System screen, select option 2, Change install 
options. This allows you to select to restore your network attributes from 
your save media. If the date and time are not correct, type new values. 
Press Enter to continue. 
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Install the Operating System 
Type options, press Enter. 
Install 
OPTION, ws ye 2 1=Take defaults (No other 
options are displayed) 
2=Change install options 
Date 
NO@arewes ecuses ays 99 00-99 
Mon this, ictecsec eos 08 01-12 
Day cers fk a 22 01-31 
Time 
HOUY ve. ce ee 16 00-23 
MinUte@o ts, 2 ss, 2 45 00-59 
Second; 3 4. = 00 00-59 
S 
__17. On the Specify Install Options screen, specify the following installation 
options. 
a 
Specify Install Options S) 
Type choices, press Enter. 
Restore option. ... _1_ 1=Restore programs and language objects 
from current media set 
2=Do not restore programs or 
language objects 
3=Restore only language objects 
from current media set 
4=Restore only language objects 
from a different media set using the 
current install device 
Job and output 
queues option. ... 2  1=Clear, 2=Keep 
Distribute 0S/400 on 
available disk units. 1. 1=Yes, 2=No e 


If your system had access path recovery times for user ASPs and the user 
ASPs have not yet been reconfigured, the system cannot restore access path 
recovery times for the ASPs. Use the Edit Recovery Times for Access Paths 
(EDTRCYAP) command to set the times after you have reconfigured your 
ASP configuration. 


18. On the Specify Restore Options screen, specify 1 for each of the following 
choices. Then press Enter. 


( >) 


Specify Restore Options 


Type choices, press Enter. 
Restore from the installation media: 


System information. . . 1 1=Restore, 2=Do not restore 
Edit descriptions ...1 1=Restore, 2=Do not restore 
Message reply list... 1 1=Restore, 2=Do not restore 
Job descriptions. ...1 1=Restore, 3=Keep customization 
Subsystem descriptions. 1 1=Restore, 3=Keep customization 
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__ 19. The OS/400 Installation Status screen displays the installation status of the 
required OS/400 Installation Profiles and Libraries. 


Fa 
Message ID . . : CPI2070 0S/400 Installation Status 


Installation Objects 
Stage Completed Restored 


Creating needed profiles and libraries .. .: 
Restoring programs to library QSYS.... .: 
Restoring language objects to library QSYS .: 
Updating program ‘table . 3 3s 3 es ee ae 
Installing database files . 2 4.6 #1 a aw 5 
Completing OS/400 installation. ......: 


(GEES ra 


__ 20. The system installs the remaining OS/400 objects. 


és 
Message ID . . : CPI2070 0S/400 Installation Status 


Installation Objects 
Stage Completed Restored 


Creating needed profiles and libraries . . .: 
Restoring programs to library QSYS .....: 
Restoring language objects to library QSYS .: 
Updating program table... 2. 2 ss 2 2 sd 
Installing database files .. 5... .% 5 « % 
Completing OS/400 installation. ......: 


09 
03 


x KK KK 


(i SRG les RO 


Af 


__ 21. On the Sign On screen, logon as user QSECOFR. You do not need to enter a 
password at this time. 


___ 22. On the IPL options screen, enter correct values for Date and Time. Only the 
following options should be set to Y: 


* Start system to restricted state 
* Set major system options 
* Define or change the system at IPL 
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f= 
IPL Options = 
Type choices, press Enter. 
Sysitemudate. x ses ee cess eh se sanepe oy hes ee 08/22/99 MM/DD/Y 
System time «s. s:35 4s SS oe ee Os 16:58:00 HH:MM:S 
Clear job queues; <4: 22 ice pce te es N Y=Yes, N=No 
Clear output queues: 2... 5 fe ee N Y=Yes, N=No 
Clear incomplete job logs ........ N Y=Yes, N=No 
Start printeweiters: 2 220 esos creew ee eae ce N Y=Yes, N=No 
Start system to restricted state ..... 4 Y=Yes, N=No 
Set major system options ......... Y Y=Yes, N=No 
Define or change system at IPL. ..... Nf Y=Yes, N=No 
XY / 


__a. On the Set Major System Options screen, select Y to enable automatic 


configuration. 


Note: If you are using these instructions during a data migration, 
select N so that automatic configuration is not enabled. 


Set Major System Options 


Type choices, press Enter. 


Enable automatic configuration... . Y Y=Yes, N=No 
Device configuration naming ..... *NORMAL  *NORMAL, *S36 
*DEVADR 

Default special environment ..... *NONE *NONE, *S36 


__ 23. The Define or Change the System at IPL screen appears. 


__a. 
b. 


Select 3, System Value Commands. 


On the System Value Commands screen, select 3, Work with System 
Values. 


On the Work with System Values screen, select the System Value that 
you plan to change by placing a "2" next to it. Press Enter ONLY 
after you select all the values. 


Update the following System Values. Write down the existing values 
so you can update them after the recovery, if necessary. 


* Change QALWOBJRST to *ALL 

* Change QJOBMSGQFL to *PRTWRAP 

* Change QJOBMSGQM«X size to a minimum value of 30 
* Change QPFRADJ to 2 

* Change QVFYOBJRST to 1 


* If you are performing a data migration, also change QIPLTYPE to 
2 


After the system changes the system values, press F3 twice to return 
to the Define or Change the System at IPL screen. 


On the Define or Change the System at IPL screen, press F3 to exit and 
continue the IPL. 


___ 24. On the Change Password screen, type QSECOFR as the current password. 
Enter a new password. Re-enter the password to verify and press Enter. 
(New password cannot be QSECOFR.) 
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(e -* 


Change Password 
Password last changed ...... xx/XX/XX 
Type choices, press Enter. 
Current: passwords. <eeie 2 a.) es QSECOFR 


New password: 35, ae ke as 
New password (to verify) ..... 


If you are performing a data migration and you set Enable automatic 
configuration to NO, use the following steps to create a tape device to 


peform_the restore. If you set Enable automatic configuration to YES, skip 
to step|27 on page 542 


25. To configure 3422, 3430, 3480, or 3490 tape units, follow these instructions. 
If you have a 3490 Model E or F or to configure other types of tape units, 


go to step [26 on page 541 
a. Use the Work with Hardware Resource (WRKHDWRSC) command to 
determine the location of the tape controller. 


WRKHDWRSC TYPE(*STG) 


b. Create the controller description for the tape controller by doing the 
following: 


1) Locate the resource name for the tape controller on the Work with 
Storage Resources display. The value 34xx is displayed in the Type 
column. 


2) Write down the name of the resource. 


3) Type a 9 (Work with resource) in the Opt column next to name of 
the tape controller and press the Enter key. You see the Work with 
Storage Resources display. 


Note: If the resource is not listed on the display, you need to select 
other resources, such as disk storage controllers. For some 
server models, resources are now attached through 
combined-function IOPs. Look through the resources until 
you find the device you want. 

4) Type 5 (Work with controller descriptions) in the Opt column in 
front of the tape controller. You see the Work with Controller 
Description display. 

5) Type 1 (Create) in the Opt column on the top line. 

6) Type the controller name (such as TAPCTLO1) in the description 
field and press the Enter key. You see the Create Controller 
Description display. 

7) If necessary, type additional information on the display. Then press 
the Enter key. You return to the Work with Controller Descriptions 
display. 

8) If the controller description that you created does not appear, press 
F5 (Refresh). 

c. To create device descriptions for the tape units that are attached to the 
controller, do the following: 
1) On the work with Controller Descriptions display, press F23 (More 
options). The list of options changes. 
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2) Type 9 (Work with associated descriptions) in the Opt column in 
front of the new tape controller. You see the Work with Associated 
Descriptions display. 

3) Locate the resource for the tape unit. Because no device description 
exists, the description says *NONE. 

4) Write down the name of the tape resource. 

5) Type a 1 (Create) in the Opt column next to the description of 
*NONE and press the Enter key. You see the Create Device Desc 
(Tape) (CRTDEVTAP). 

6) In the Device description field, type a name such as TAPO1. 

7) In the Resource name prompt, type the name that you wrote down 


in step (If you did not write it down, press F12 to return to 
the display. Repeat steps through 25c7]) 


8) Press the Enter key. 
9) Additional parameters appear on the display. 

10) If necessary, type additional information on the display. Then press 
the Enter key. You return to the Work with Associated Descriptions 
display. 

11) Press F5 (Refresh). The name of the description that you created 
should now be associated with the resource. 

12) Type 8 (Work with configuration status) in front of the controller 
description and the device description. You see the Work with 
Configuration Status display. 

13) Type 1 (Vary on or Make available) in front of the controller and 
the devices. 

d. Press F3 until your return to your original menu. 
__ 26. To configure tape units that are 3490 Model E or F, or that are not models 
34xx, use the following instructions: 
a. Use the Work with Hardware Resource (WRKHDWRSC) command to 
determine tape controller name. 

WRKHDWRSC TYPE(*STG) 

b. Locate the tape controller on the Work with Hardware Resources 
display. 

c. Type a 9 (Work with resource) next to tape controller name and press 
the Enter key. 


Note: If the tape controller is not listed on the display, you need to 
select other resources, such as disk storage controllers. For some 
server models, tape units are now attached through 
combined-function IOPs. Look through the resources until you 
find the tape unit you want. 


d. Locate the resource name for the tape unit (for example, TAP01). 


e. Enter a 5 (Work with Configuration Descriptions) in the Opt column 
next to the tape resource name and press the Enter key. 


You are shown the Work with Configuration Descriptions display. 


f. Type a1 (Create) in the Opt field and a tape device description name 
(for example, TAPO1) in the Description field. Press the Enter key. You 
are shown the Create Device Description (Tape) display. 
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g. Change any values that you want to change, then press the Enter key 
(twice) to create the device description. You are shown the Work with 
Configuration Descriptions display again. The device that you created 
should appear on the display. 

h. Type an 8 (Work with configuration status) in front of the new device 
description. You are shown the Work with Configuration Status display. 

i. Type a 1 (Vary on or Make available) in front of the new device. If the 

status does not change to Varied On or Available, wait a few minutes. 
Then press F5 (Refresh). If the status still does not change to Varied On 
or Available, follow normal problem analysis for the device. 

j. Press F3 until you return to the main menu. 


__ 27. On the OS/400 Main Menu screen, type the command, WRKRPYLE, and check 
to see if CPA3709 is there. If it is not, determine an available sequence 
number and then Press F6 to add MSGID(CPA3709) RPY(G) by using the 
available sequence number. Press F5 to Refresh and verify that you added 
CPA3709. 


rc ~ 


0S/400 Main Menu 
Select one of the following: 


. User tasks 

. Office tasks 

. General system tasks 

. Files, libraries, and folders 
. Programming 

. Communications 

. Define or change the system 
. Problem handling 

. Display a menu 

. Client Access/400 tasks 

. Sign off 


OrOOAnNnNaOBWNYE 


wor 


Selection or command 
=> 


Se yy 


__a. Type the command CHGJOB INQMSGRPY(*SYSRPYL) to update the 
current job to use the system reply list for inquiry messages. 


__ 28. On the OS/400 Main Menu screen, type GO RESTORE to access the Restore 
screen. 


__a. On the Restore screen, select option 21, Restore System and User 
Data. 


__b. Press Enter to continue. 


__ 29. On the Specify Command Defaults screen, enter the name of the tape drive 
that you are using for the restore. 


__a. Set Prompt for command to N. 
__b. Set Message queue delivery to *NOTIFY. 
__c. Set Restore to different system to Y. 
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Specify Command Defaults 


Type choices, press Enter. 


TAP EMGeVACOS: va een ces cs. os con eset ere TAPO1 Names 

Prompt for commands. ........ N Y=Yes, N=No 
Message queue delivery ....... *NOTIFY *BREAK, *NOTIFY 
Restore to different system. .... Y Y=Yes, N=No 


__d. Press Enter to continue ending the subsystems. The restore process 
starts to run unattended. The restore process stops only if the system 
requires a tape mount for the restore process to continue. The restore 
process should run to completion. 


___ 30. Ifa controller or device no longer has a valid resource on the system, use 


__ 31. 


__ 32. 


33. 


34. 


the Work with Hardware Product (WRKHDWPRD) command to correct the 
hardware resource names. See Installation, upgrades, and migration -> 
Migration —> Perform the migration —-> Complete the migration —> 
correct hardware resource names in the iSeries Information Center at 
http://www.ibm.com/eserver/iseries/infocenter for instructions. 


Reapply any PTFs that you applied since since the last time that you saved 
your system data. 


a. Locate the most recent cumulative PTF (program temporary fix) 
tape/CD. 


b. From a command-line, enter GO PTF to access the PTF menu. 


c. Select 8, Install program temporary fix package, on the PTF menu. 
This installs all of the PTFs in the cumulative PTF package for the 
licensed programs that are installed on your system. Refer to the 
OS/400 PTF Shipping Information Letter for required special 
instructions. 

Notes: 


1) If you want to restore individual PTFs, see the Systems Operation 
publication for more information about applying individual 
PTFs. 


2) If you do not have the PTFs that you need, order them and 
apply them later. 


If necessary, change the following system values back to its original value 
by using the WRKSYSVAL command. 


* QALWOBJRST 
* QJOBMSGQFL 
* QJOBMSGQMX 
* QIPLTYPE 

* QPFRAD] 

* QVFYOBJRST 


If you do not know the password for the restored QSECOFR profile, 
change the password before signing off. Type the following command and 
press Enter: 


CHGUSRPRF USRPRF(QSECOFR) PASSWORD (new-password) 
To place scheduled jobs on hold, type WRKJOBSCDE and select option 3 to 
[41 on| on 


hold any scheduled jobs. You need to release the jobs in Step 
age 54dlafter you complete the restore. 
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___ 35. Type the command, SIGNOFF *LIST or DSPJOBLOG * *PRINT. Check the job 
log to ensure that the job restored all objects. To verify if the job restored 
all objects, spool the job log for printing along with any remaining spooled 
job output. Check for any error messages. Correct the errors and restore 
those objects from media. 

36. Perform an IPL of the system. 

a. On the CPU control panel, select the NORMAL setting. 


b. Type the following command and press Enter: 


PWRDWNSYS OPTION(*IMMED) RESTART(*YES 
*FULL) IPLSRC(B) 
__ 37. If you installed IBM Content Manager OnDemand for iSeries (5769-RD1) 
on your system, restart the journaling for IBM Content Manager 
OnDemand for iSeries (5769-RD1) by typing the following commands: 


CALL QRDARS/QRLCSTRJ PARM('RLC') 
CALL QRDARS/QRLCSTRJ PARM('RLR') 
CALL QRDARS/QRLCSTRJ PARM('RLO') 


__ 38. If you installed iSeries Integration for Windows Server (5722-WSV) on 
your system and you saved with your network servers in a VARIED ON 
setting, perform the following steps: 

__a. Vary off any network servers that are varied on by using the 
WRKCFGSTS *NWS command. Select option 2. 

b. Create any needed Network Storages by using the CRTNWSSTG 

command. 

c. Add the storage links by using the ADDNWSSTGL command. 

d. Vary on your network servers by using the WRKCFGSTS «NWS 

command. Select option 1. 
e. Restore iSeries Integration for Windows Server (5722-WSV) data by 
typing RST OBJ('/QNTC'). 
__f. Press Enter. 
__g. Follow the instructions in Step B5]to check for error messages, verify 
your restore, and correct any errors. 

__ 39. If you installed iSeries Integration for Windows Server (5722-WSV) on 
your system and you saved with your network servers in a VARIED OFF 
setting, perform the following steps: 

a. Add the links for the server descriptions. Type the following for 

each server description: 


ADDNWSSTGL NWSSTG(Storage Name) NWSD(Server_ Description) 
b. Vary on your network servers by typing WRKCFGSTS *NWS and by 
selecting option 1 to vary on each network server. 
__ 40. If you installed Cryptographic Access Provider 128-bit for iSeries 
(5769-AC3) on your system, reinstall it by using option 11 on the Work with 
Licensed Programs menu. 


__ 41. Release the jobs that you previously held in Step|34 on page 543} You have 


completed the recovery. 
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Appendix F. Notices 


This information was developed for products and services offered in the U.S.A. 
IBM may not offer the products, services, or features discussed in this document in 
other countries. Consult your local IBM representative for information on the 
products and services currently available in your area. Any reference to an IBM 
product, program, or service is not intended to state or imply that only that IBM 
product, program, or service may be used. Any functionally equivalent product, 
program, or service that does not infringe any IBM intellectual property right may 
be used instead. However, it is the user’s responsibility to evaluate and verify the 
operation of any non-IBM product, program, or service. 


IBM may have patents or pending patent applications covering subject matter 
described in this document. The furnishing of this document does not give you 
any license to these patents. You can send license inquiries, in writing, to: 


IBM Director of Licensing 
IBM Corporation 

500 Columbus Avenue 
Thornwood, NY 10594. 
U.S.A. 


For license inquiries regarding double-byte (DBCS) information, contact the IBM 
Intellectual Property Department in your country or send inquiries, in writing, to: 


IBM World Trade Asia Corporation 
Licensing 

2-31 Roppongi 3-chome, Minato-ku 
Tokyo 106-0032, Japan 


The following paragraph does not apply to the United Kingdom or any other 
country where such provisions are inconsistent with local law: 
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS 
PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER 
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS 
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or 
implied warranties in certain transactions, therefore, this statement may not apply 
to you. 


This information could include technical inaccuracies or typographical errors. 
Changes are periodically made to the information herein; these changes will be 
incorporated in new editions of the publication. IBM may make improvements 
and/or changes in the product(s) and/or the program(s) described in this 
publication at any time without notice. 


Any references in this information to non-IBM Web sites are provided for 
convenience only and do not in any manner serve as an endorsement of those Web 
sites. The materials at those Web sites are not part of the materials for this IBM 
product and use of those Web sites is at your own risk. 


Licensees of this program who wish to have information about it for the purpose 
of enabling: (i) the exchange of information between independently created 
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programs and other programs (including this one) and (ii) the mutual use of the 
information which has been exchanged, should contact: 


IBM Corporation 

Software Interoperability Coordinator 
3605 Highway 52 N 

Rochester, MN 55901-7829 

Las 


Such information may be available, subject to appropriate terms and conditions, 
including in some cases, payment of a fee. 


The licensed program described in this information and all licensed material 
available for it are provided by IBM under terms of the IBM Customer Agreement, 
IBM International Program License Agreement, or any equivalent agreement 
between us. 


Any performance data contained herein was determined in a controlled 
environment. Therefore, the results obtained in other operating environments may 
vary significantly. Some measurements may have been made on development-level 
systems and there is no guarantee that these measurements will be the same on 
generally available systems. Furthermore, some measurement may have been 
estimated through extrapolation. Actual results may vary. Users of this document 
should verify the applicable data for their specific environment. 


Information concerning non-IBM products was obtained from the suppliers of 
those products, their published announcements or other publicly available sources. 
IBM has not tested those products and cannot confirm the accuracy of 
performance, compatibility or any other claims related to non-IBM products. 
Questions on the capabilities of non-IBM products should be addressed to the 
suppliers of those products. 


All statements regarding IBM’s future direction or intent are subject to change or 
withdrawal without notice, and represent goals and objectives only. 


COPYRIGHT LICENSE: 


This information contains sample application programs in source language, which 
illustrates programming techniques on various operating platforms. You may copy, 
modify, and distribute these sample programs in any form without payment to 
IBM, for the purposes of developing, using, marketing or distributing application 
programs conforming to the application programming interface for the operating 
platform for which the sample programs are written. These examples have not 
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or 
imply reliability, serviceability, or function of these programs. You may copy, 
modify, and distribute these sample programs in any form without payment to 
IBM for the purposes of developing, using, marketing, or distributing application 
programs conforming to IBM’s application programming interfaces. 


If you are viewing this information softcopy, the photographs and color 
illustrations may not appear. 


Trademarks 


The following terms are trademarks of International Business Machines 
Corporation in the United States, or other countries, or both: 
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400 

Application System /400 
APPN 

AS/400 

AS/400e 

C/400 

CICS 

COBOL 

COBOL /400 

DB2 

DisplayWrite 
Distributed Relational Database Architecture 
DRDA 

ECS 

FORTRAN/400 

IBM 

IBM Payment Server 
ILE 

Integrated Language Environment 
iSeries 

MOSeries 

Netfinity 
OfficeVision/ 400 
Operating System /400 
OS/2 

OS/400 

PLI 

PowerPC 

PS/2 

RM/COBOL-85 
RPG/400 

RT 

SAA 

SQL/400 

System /36 

System /370 

System /38 

Ultimedia 

VisualAge 

Visual Warehouse 
WebSphere 


Java is a registered trademark of Sun Microsystems, Inc. 


Lotus® and Domino are trademarks of Lotus Development Corporation in the 
United States, or other countries, or both. 


Microsoft®, Windows, Windows NT®, and the Windows 95 logo are registered 
trademarks of Microsoft Corporation. 


Tivoli is a registered trademark of Tivoli Systems Inc. 
UNIX® is a registered trademark in the United States and other countries licensed 
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